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This, document contains an alphabetical listing 
of all available functions in the Thermovision® 
900 system. A Quick Reference guide at the end 
of this chapter lists the genuine functions and a 
number of appropriate keywords with references 
to their relevant system functions. The 
keywords are intended to be helpful when 
looking for the description of a function without 
knowing its precise name. The complete Menu 
Tree is also provided as a quick reference to the 
route required to locate a particular function. 
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1.1. Document 
Conventions 


o 

o 


Each function is described as follows: 

MENU: 

The name of the menu in which the function 
appears in the system. The names and 
placement of menus are described in the 
following section. 

OPTIONS: 

A list of the possible options or parameters the 
function may have. Usually such choices will be 
in a sub-menu under the main function. 

DESCRIPTION: 

A short description of the function and of each 
of the options available. 

Please note that the description of functions in 
this document assumes the reader is familiar 
with the operation and architecture of the 
Thermovision®9(X) system. If not, the reader 
should first consult the “Tutorial’’ where the 
system operating principles are explained. 
Information can also be found in the On-line 
Help texts. 


O 

o 
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1.2. System Controls The ERIKA software is structured around the X- 

windows presentation system. The system 
controls are as follows: 

1.2.1. Mouse Controls 

There are three basic mouse techniques used 
within the system: 

• Pointing 

• Clicking 

• Dragging 

The mouse controls the pointer on the screen. 
The different pointers and their uses are 
explained in the next section. The pointer is 
moved by moving the mouse over the desk top 
in the direction the pointer is required to move. 
Moving the mouse slowly results in small 
movements of the pointer, while moving the 
mouse faster produces larger pointer 
movements. 

Clicking means pressing and quickly releasing a 
mouse button. By pointing at a window or menu 
option on the screen and then clicking a mouse 
button, menus or menu options are selected. 

Dragging means holding down a mouse button 
and moving the pointer. In this way objects can 
be moved around the screen or resized. 

Menus are opened and selections made by 
positioning the mouse pointer and clicking the 
left mouse button. Dragging within a window 
uses the left mouse button. Releasing the mouse 
button completes the action. 

When clicking on window scroll bars to view 
text, lists, etc. both mouse buttons are used. 

Positioning the pointer on a window title bar or 
icon and clicking the right mouse button brings 
that window/icon to the front. By clicking and 
dragging on the title bar using the right button 
the window is both moved to a new position and 
brought to the front. 

Menus opened in error can be cancelled by 
positioning the pointer outside the menu box or 
in the menu title and clicking either mouse 
button. 
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1.2.2. Pointers 


The following pointer symbols are used: 
X Background pointer 

^ Window pointer. 
f| Button pointer 

Button pointer - in title bar 


0 

Q 


Menu pointer 

Version window appearing 

Please wait! 


+ 


Cross-hairs - Used to locate Spots and 
start and end points of Lines and Areas 
within IR image 




Move pointer - Used when moving or 
resizing a window 


Text Editor symbol - Used to show that 
text (or a value) is to be entered 


® Window selection symbol. Used when 
moving windows to the front or back and 
when removing windows 

Remove symbol - used when removing a 
^ window 


1.2.3. Keyboard 

The keyboard is a specially modified enhanced 
keyboard. The numeric keypad has been 
replaced with the controls for level and span, 
and isotherms while the majority of the function 
keys have been dedicated to specific tasks. The 
main keyboard uses the US standard layout. 

Level and span are adjusted from the keyboard. 
Level or Span is selected by pressing the 
relevant key and the rotary knob is then used to 
change the settings. The levels of isotherms 1 
and 2 are adjusted in the same way. Each of the 
keys around the rotary knob has an LED to 
indicate which function has been selected. Two 
LEDs in the indicator panel above the rotary 
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knob section of the keyboard indicate which IR 
window is active. The pre-defined function keys 
are described in detail in the relevant function 
descriptions. 


vJ 

O 


o 

o 
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1.3. Windows, 
Menus and 
Functions 


In order to open the menus listed in the 
alphabetical list of functions, their location with 
respect to the various windows must be 
understood. The following schematic diagram 
shows the location of each of the menus. 



The Thermovision®900 software (ERIKA) uses 
an object oriented approach to menus. Each 
element on the screen can be clicked on 
bringing up a menu with actions relevant to the 
element. The BACKGROUND area represents 
the system as a whole. 

Some of the actions lead to tasks that are 
performed while allowing the operator to 
continue using the system (background tasks). 
Others lead to foreground tasks that must be 
completed before the operator can continue. 
These cause the system to appear locked. The 
operator can usually tell when the system is 
busy as a red hourglass symbol in most cases 
appears at the right hand end of the TOPLINE. 
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The TOPLINE is effectively the title bar for the 
screen presentation and contains the CURRENT 
LOCATION (or directory path) of the files in 
use. 


1.3.1. Background Menus 

The above menus are obtained as follows: 

TOP LINE menu 

Positioning the pointer on the TOPLINE and 
clicking the mouse button brings up the TOP 
LINE menu. This menu contains extra functions 
used for demo and test. 

SYSTEM menu 

The SYSTEM menu is the top level menu. 
Clicking the left mouse button with the pointer 
positioned anywhere within the background 
brings up the SYSTEM menu. The menu 
appears at the location of the pointer.. 

CLOCK menu 

If any of the clock windows, either the 
ANALOG or DIGITAL clock window, has been 
selected from the CREATE WINDOW option 
of the SYSTEM menu, then positioning the 
pointer anywhere within the boundary of the 
clock window and clicking the left mouse 
button will bring up the CLOCK menu. The 
clock can then be moved or resized and the date 
and time set. 

COMPANY LEVEL menu 

You can put up a window with the company 
level and logo on the screen provided the 
company name and logo have been stored 
before. 

Provided those files are available, select 
CREATE WINDOW in the SYSTEM menu. 
Click on Company label and write the 
corresponding file names into the dialog panel. 

The Company label window thus created can be 
moved to a suitable place on the screen. 
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o 
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ICON menu 

When a window is closed using the CLOSE 
option it reduces to an ICON representing the 
window. Clicking the left mouse button with the 
pointer positioned within the icon boundary 
brings up the ICON menu. The icon can then be 
moved or the window re-opened. 

1.3.2. IR Window 

This window contains the IR image and the 
information concerning the image. It is divided 
into several sections. The section to the right of 
the image contains the temperature scale in the 
form of a vertical bar displaying the colours or 
grey scale used in the image and the 
temperature represented by each colour. 

If selected, the isotherm result lines will come 
up immediately below the image, one line per 
selected isotherm. Normally, however, there is a 
graphic presentation comparing the level and 
span set by the controls with the temperature 
information coming from the source. Below this 
is a text field containing the source information 
and the first 35 characters of the comment used 
as a Title. 

In the right hand comer of the IR window is the 
Status field containing information about the 
measurement units (Object Signal, Centigrade, 
Fahrenheit, Kelvin) and image parameters 
(INVALID, Level and Span, Object Parameters 
for scaling, Comment). LS, OPSC and C 
inform the operator that the parameters or 
comment are not those from the source. 

1.3.3. IR Window Menus 

Two specific menus can be opened from within 
the IR window as follows: 

IR menu 

This menu is opened by positioning the pointer 
within the image boundary and clicking a 
mouse button. Other sub-windows can then be 
opened, the image size can be changed and 
analysis of the image can then be performed. 
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Scale menu 

The scale used in the image is displayed at the 
right of the image. The scale menu can be 
opened by positioning the pointer within the 
scale section of the IR window and clicking a 
mouse button. The palette can then be selected, 
the object parameters can be changed, the level 
and span can be set and possible offset 
correction can be introduced. 

1.3A Window Menu and Window Title 
Bar 

When any window is open, a window menu and 
other window handling functions can be reached 
from its title bar. A window is selected by 
moving the pointer to within its boundaries. The 
window title bar then becomes active. 

The WINDOW menu can be obtained by 
positioning the pointer in the centre section of 
the title bar and clicking the mouse button. 
Window handling options, allowing the window 
to be moved, resized, closed or removed, are 
then available. 

The window can also be resized by positioning 
the pointer in the extreme right hand box of the 
title bar and pressing and holding the mouse 
button down. The pointer changes to the move 
symbol and the window can then be resized by 
dragging the pointer with the mouse. The new 
window size is outlined on the screen. Releasing 
the mouse button completes the resizing action. 

To the left of the resize corner of the window 
title bar is the lock input selection. Clicking on 
this symbol locks the window selection. All 
menu and function actions are performed on the 
locked window irrespective of the position of 
the mouse pointer. No other window can be 
selected until the locked window has been 
unlocked by selecting the Unlock Input option 
in the Window Handling menu or lock input in 
another window. 

The window can be closed (reduced to an icon) 
by positioning the pointer over the small 
AGEMA logo at the left hand end of the title 
bar and clicking the left mouse button. 
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1.4. Dialog panels 


o 

G 


On selecting some menu options, a dialog panel 
opens requesting additional information or 
requiring that a further selection be made. 

These further selections will normally be 
presented with a “button” alongside or with the 
selection appearing on the “button”. The 
selection is made by pressing the button, i.e. 
positioning the mouse pointer over the button 
and clicking. In some cases the button then 
appears to be latched in the down position. 
Clicking on the button again or selecting 
another option releases the button to the up 
position. 

The symbols on the buttons indicate the type of 
selection possible: 

Single choice - only one button may be 
<1==^ selected at a time 

Multiple choice - Any or all buttons may 
be selected 

Rolling selection - Cycles through 
selections displayed in a text field 
alongside 

If the dialog panel requires that text be entered 
then the text editor pointer is positioned within 
the boundary of the dialog panel and the arrow 
keys used to select the text entry point (shown 
by the cursor position). The arrow keys also 
move the cursor between text fields. An active 
cursor is shown as U and the inactive cursor as 


o 

G 


When the information requested has been 
completed then clicking on the OK button, 
normally located at the bottom of the panel, 
loads the information. 

Clicking on the CANCEL button removes the 
dialog panel and no action is taken. 

Clicking on the HELP button brings up a Help 
text window with information concerning the 
action being performed. The operator can also 
examine other Help texts. 

In some dialog panels a LIST button is also 
displayed. Clicking on this button brings up a 
further dialog panel with a list of the current 
directories and files available. 
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1.5. Control panels There are several control panels used in the 

system for controlling specific functions in the 
background. Examples of these are the Scanner 
Control and Recall Sequence panels. They 
differ from the dialog panels in that there are no 
text fields requiring input from the operator. 


o 

o 


o 

o 
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1.6. Warning panels 


o 

<0 


At any time during the operation of the system 
the user may receive information concerning 
errors or warnings. These are displayed in the 
form of panels stating the location of the error 
or warning and giving information as to the 
cause of the error or the system function that 
requires attention. The warning panels can be 
given in three different colours, white, yellow 
and red, where a white panel only carries 
information, the yellow one indicates a probable 
operator error whereas the red window might 
indicate a system fault. 

It is recommended to take notes of any error 
panel that appears. Clicking on the CONFIRM 
button acknowledges that the problem has been 
noted. The user can also ask for help by clicking 
on the HELP button. 


o 

o 
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1.7 Menu Tree 

I 


1.7.1 

System Menu 

1-15 

1.7.2 

Top Line Menu 

1-16 

1.73 

IR Menu 

1-17 

1.7.4 

Scale Menu 

1-18 

1.7.5 

Spot Menu 

1-19 

1.7.6 

Line Menu 

1-19 

1.7.7 

Area Menu 

1-20 

1.7.8 

Plot Menu 

1-20 

1.7.9 

Result Window 

1-21 

1.7.10 

Clock Menu 

1-21 

1.7.11 

Company Label 
Menu 

1-22 


u 

o 


O 

o 


M4 



Thermovision® 900 Series 


1.7.1 System Menu 


o 

o 
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1.7.3 IR Menu 


o 

o 


o 

o 
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1.7.4 Scale Menu 



o 

o 


o 

o 
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1.7.5 Spot Menu 



1.7.6 Line Menu 
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1.7.7 Area Menu 



o 

o 


1.7.8 Plot Menu 

Right button: 


PLOT 


Add cursor 
Remove cursor 
Store 
Recall 
Scaling 
Plot on/off 
Status 
Abs/rel time 
Clear all 

-- 


o 

o 
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1.7.9 Result Window handling 


On the first line of the result window: 


O 


RESULT WINDOW 


Print 

Show abs time 
Show rel time 


Remove 
Menu off 


On the Time line: 


TIME 

\ 

Remove 


Menu off 



j 


On the next lines of the result window: 


RESULT 


_) 


1.7.10 Clock Menu 


o 

o 


( -^ 

CLOCK 

^ _ / 


CLOCK MENU 

N 

Move 


Front 


Back 


Resize 


Set date & time 


Help 



y Remove_J 


Front and move 
(right button) 
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1.8. Quick reference The following is a list of all functions to be 

found in this manual. Some keywords have also 
been added to aid identification of the function 
required. 


Absolute time/relative time 

Acceptance 

Add area 

Add line 

Add spots 

Align 

Align and mix 

Align and subtract 

Align and subtraction control 

Analog clock 

Analyse image 

Append sequence 

Auto adjust, see Level and span 

Aux file handling 

Average, see Time processing control 

Back 

Base time 

Beep, see Sound on/off 
Bitmap 

Break command 
Box, see Add area 
Circle, see Add area 
Close, see also Remove 
Colour palettes 

Comment, see Image comment 

Company label 

Copy 

Copy file 

Copy sequence 

Create subwindow 

Create window 

Customer data, see Create subwindow 

Delete directory file 

Delete file 

Delete sequence 

Digital clock 

Directory of directory files 
Directory of files 
Display processing control 
DOS convert file 
DOS copy file 
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Dump image file 
Ecalc, see Obj Par Scaling 
Edit text file 

Edit comment, see Image comment 

Edit Object parameters, see Obj Par SCaling 

Ellipse, see Add area 

Equipment 

Ethernet info 

Extreme values, see Results 
File handling 
File toolbox, see Toolbox 
File transfer 

Filter selection, see Scanner control 

Filter toolbox, see Toolbox 

Focus + -, Refer to Hardware Manual 

Format floppy disk 

Freeze 

From source 

Front 

Function keys 
Grey palettes 
Help 

Histogram, see Results 
Image base time 
Image comment 

Image scanner data, see Create subwindow 
Installed options 
Interlace on/off 

IR status, see Create subwindow 
IR toolbox, see Toolbox 
IR window size, see Size 
Isotherm handling 

Keep comment, see Image comment 
Keep current 

Keep parameters, see Obj Par for SCaling 

Level and span 

Line, see Add line 

Lock input, see Unlock input 

Make directory file 

Make toolbox, see Show other manip’d 
Maxmin 

Mirror, see Display processing control 
Motor power on/off 
Move 
Move file 

Named, see Time/Display processing Control 
Object parameters 
Obj Par for SCaling 
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Offset correction 
Open 

Open IR window, see Create window 

OS9 

Plot 

Profile, see Results 

Range selection, see Scanner control 

Recall 

Recall comment, see Image comment 
Recall image(s) 

Recall object paramenters, see Obj Par SCaling 
Recall sequence 

Recursive, see Show other manip'ed 

Refresh screen 

Relative to base 

Remove, see also Close 

Remove analysis 

Rename file 

Re-read .agwmrc 

Reshape 

Resize 

Results 

Result table, see Create subwindow 
Rotate, see Display processing control 
Run macro 
Scanner 

Scanner content 

Scanner control 

Scanner loading 

Screen saver on/off 

Select Source 

Set background 

Set base time 

Set date and time 

Set location 

Set palette 

Set printer port 

Set toolbox, see Toolbox 

Show absolute time, relative 

Show ERIKA version 

Show other manipulated 

Show other IR window 

Show scanner 

Size 

Sound on/off 

Span, see Level and span 

Spot, see Add spot 


o 

o 


vJ 

o 


1-26 




Thermovision^^OO Series 


u 

o 


Statistics, see Results 
Store 

Store comment, see Image comment 
Store image 

Store object paramenters, see Obj Par SCaling 

Store sequence 

Subtract 

SWcopy, see Display processing control 

System fitness 

Time presentation 

Time processing control 

Toolbox 

Trig A, B, see Store sequence 

Unlock input 

User defined menu 

View, see Display processing control 

Window handling 

X demo 


o 

o 
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2. System Functions 
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ABSOLUTE TIME 


MENU; Time presentation menu 

OPTIONS: 


DESCRIPTION 

o 


The IR window presents the image capture time in a line 
below the image. The information can also be shown in 
the result window. In this case it shows the absolute time 
of the clock. 


o 


G 


G 
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MENU: 

OPTIONS: 

DESCRIPTION 


ABSOLUTE/RELATIVE TIME 


Plot menu 

Result window menu 

Absolute time 
Relative time 
Show absolute time 
Show relative time 


In the plot menu the time for the plots can be set either to 
absolute time, i.e. the time of the clock(s) or to relative 
time, i.e. a time which is relative to the base time. 

See the function Set base time 

In the result window(s) the time can be shown by clicking 
on the first line of the window. The selected time, i.e. 
absolute or relative time, see above, will then be shown in 
a new line just under the first line of the results window. 
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ACCEPTANCE 


MENU: IR menu 

OPTIONS: 


o 

o 


DESCRIPTION 


This panel controls the image acceptance. Images are 
accepted according to the defined conditions. The plot 
process for example will only plot accepted images. 
Without the acceptance process active all images are 
accepted. 

Upon clicking on Acceptance in the IR menu the 
acceptance dialog panel will be brought up. There is a 
number of options to select. 


First of all there are the START acceptance options. 


Click on the arrow down button in the dialog panel to 
step through the different options. They are the following: 


O 


Now Starts the image acceptance as 

soon as the OK button is clicked 
on. 

At HH:MM:SS Starts the image acceptance at the 

time specified. The time is entered 
in the text field under the option 
field. If the complete time is not 
entered the system assumes the 
first pair of numbers to be the 
hours. 


o 


At Keyboard Trig: Starts the image acceptance when 

a keyboard trig button is pressed. 

At External Trig: Starts the image acceptance when 

an external trig button is pressed. 


Next option to be set is the ACCEPT option. Go through 
the various options as for the START option. 

All images 


Accepts all images. 
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At HH:MM:SS interval: Accepts an image at the time 
interval set. The time is entered in 
the text field under the option 
field. If the complete interval time is 
not entered the system assumes the 
last pair of numbers to be the 
seconds. 

At Keyboard Trig: Accepts an image when a keyboard 
trig is pressed. 

At External Trig: Accepts an image when an external 
trig is pressed. 

The final option to be set is the UNTIL option. Select as 
for the other options. 

Forever: Accepts images forMever. 

H:MM:SS duration: Acceptance is stopped after the 
duration set. The time is entered in the text field under the 
option field. If the complete duration time is not entered 
the system assumes the last pair of numbers to be the 
seconds. 

At Keyboard Trig: Stops image acceptance on a 
keyboard trig. 

At External Trig: Stops image acceptance when on 
external trig. 

Click the OK button in the dialog panel to start or to 
modify the acceptance control process. 

The HELP button brings up a help text window with 
information about the ACCEPTANCE function. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 

Upon pressing OK a control panel will appear, in which 
the numbers of accepted and lost images will be presented. 
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ADD AREA 


MENU: IR menu - Analyse image - Add Spol/Line/Area 

OPTIONS: Area 

Box 


DESCRIPTION 

Allows an area of interest in the image to be analysed. 

When ADD SPOT/LINE/AREA is selected from the 
ANALYSE IMAGE menu the text window under the 
image is replaced with a set of selection buttons: 

ADD EDIT UNDO 

OK/COMPLETE HELP CANCEL 


Alongside the buttons, in a separate field, appears the 
instruction - "Press ADD". Clicking on the ADD button 
brings up a short menu with the analysis options: Spots, 
Line, Box, Area, Circle, Ellipse. 

Clicking on the AREA or BOX option changes the pointer 
to the crosshair symbol which is used to select the comers 
of the required area. The OK button changes to 
COMPLETE. Position the crosshairs at the point required 
for the start of the area and click the left mouse button. 
Select the next corner point and click again. A line joins 
the two points together. If the mouse button is kept 
depressed while moving the crosshairs the line is moved 
dynamically. The image coordinates are displayed for 
each corner as it is selected. With the BOX option only 
two diagonally opposite comers are needed. 


O 


Continue selecting the comer positions (a maximum of 64 
comers can be used) and the area outline will be created. It 
is not necessary to select the start point again to complete 
the area as the system will automatically connect the last 
comer to the first when the COMPLETE button is clicked 
on. This line will not be completed if it crosses part of the 
area selected. "Crossing" is shown in the field alongside 
the buttons. 

Clicking on the CIRCLE or ELLIPSE option changes the 
pointer to the crosshair symbol. Position this pointer there, 
where you want the centre of the circle to be and click on 







Software Reference Manual 


the mouse. Then the next point will define a point on the 
crosshair symbol which is used to select the comers of the 
required line. The OK button changes to COMPLETE. 
Position the crosshairs at the point required for the start of 
the line and click the left mouse button. Select the next 
point and click again. A line joins the two points together. 
If the mouse button is kept depressed while moving the 
crosshairs the line is moved dynamically. The image 
coordinates are displayed for each point as it is selected. 

Continue selecting the comer positions (a maximum of 64 
comers can be used) and the line will be created. 

Clicking on the EDIT button brings up a menu with 
MOVE and RESHAPE options. Refer to the MOVE/ 
RESHAPE function descriptions. 

Clicking on the UNDO button before the COMPLETE 
button is clicked removes the last line drawn. After the 
COMPLETE button has been clicked on the UNDO button 
removes the complete line from the image. 

The CANCEL button cancels the Add line function and 
removes the buttons from the screen. 

The HELP button brings up a help text window with 
information on the Add line function. 

After clicking on the COMPLETE button, after selecting 
the last point, the button reverts to OK. Clicking on the 
OK button changes the line colour and adds an 
identification flag (LIOl, 02, etc.). Further Spots/Area/ 
Lines can be added before clicking on OK. 

In the Results window, which was opened when you 
clicked on Analysis image, a line identification number 
will be entered. Further analysis on a time-temperature 
plot basis can be activated by clicking on this line. Refer 
to the PLOT function description for further details. 

Further analysis options are available in the Line menu. 
Refer to the RESULTS function description for further 
details. 


O 

O 
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ADD LINE 


MENU: IR menu - Analyse image - Add Spot/Line/Area 

OPTIONS: 


, DESCRIPTION 


Allows the image temperatures along a line to be 
analysed. 


When ADD SPOT/LINE/AREA is selected from the 
ANALYSE IMAGE menu the text window under the 
image is replaced with a set of selection buttons: 

ADD EDIT UNDO 

OK/COMPLETE HELP CANCEL 


O 

o 


Alongside the buttons, in a separate field, appears the 
instruction - "Press ADD". Clicking on the ADD button 
brings up a short menu with the analysis options: Spots, 
Line, Box, Area. 

Clicking on the LINE option changes the pointer to the 
crosshair symbol which is used to select the comers of the 
required line. The OK button changes to COMPLETE. 
Position the crosshairs at the point required for the start of 
the line and click the left mouse button. Select the next 
point and click again. A line joins the two points together. 
If the mouse button is kept depressed while moving the 
crosshairs the line is moved dynamically. The image 
coordinates are displayed for each point as it is selected. 

Continue selecting the comer positions (a maximum of 64 
comers can be used) and the line will be created. 

Clicking on the EDIT button brings up a menu with 
MOVE and RESHAPE options. Refer to the MOVE/ 
RESHAPE function descriptions. 

Clicking on the UNDO button before the COMPLETE 
button is clicked removes the last line drawn. After the 
COMPLETE button has been clicked on the UNDO button 
removes the complete line from the image. 

The CANCEL button cancels the Add line function and 
removes the buttons from the screen. 
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The HELP button brings up a help text window with 
information on the Add line function. 

After clicking on the COMPLETE button, after selecting 
the last point, the button reverts to OK. Clicking on the 
OK button changes the line colour and adds an 
identification flag (LIOl, 02, etc.). Further Spots/Area/ 
Lines can be added before clicking on OK. 

In the Results window, which was opened when you 
clicked on Analysis image, a line identification number 
will be entered. Further analysis on a time-temperature 
plot basis can be activated by clicking on this line. Refer 
to the PLOT function description for further details. 

Further analysis options are available in the Line menu. 
Refer to the RESULTS function description for further 
details. 
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ADD SPOT 


MENU: IR menu - Analyse image - Add Spot/Line/Area 

OPTIONS: 


DESCRIPTION 

o 


Allows the image temperature at selected points to be 
analysed. 


O 


When ADD SPOT/LINE/AREA is selected from the 
ANALYSE IMAGE menu the text window under the 
image is replaced with a set of selection buttons: 

ADD EDIT UNDO 

OK HELP CANCEL 


Alongside the buttons, in a separate field, appears the 
instruction - Tress ADD”. Clicking on the ADD button 
brings up a short menu with the analysis options: Spots, 
Line. Box, Area. 

Clicking on the SPOTS option changes the pointer to the 
crosshair symbol which is used to select the points 
required. Position the crosshairs at the point required and 
click the left mouse button. Select the next spot (a 
maximum of 99 spots can be used) and click again. The 
image coordinates are displayed for each spot as it is 
selected. 


o 

O 


Clicking on the EDIT button brings up a menu with the 
MOVE option. Refer to the MOVE function description. 

Clicking on the UNDO button removes the spot from the 
image. 

The CANCEL button cancels the Add spots function and 
removes the buttons from the screen. 

The HELP button brings up a help text window with 
information on the Add spots function. 

Clicking on the OK button adds an identification flag 
(SPOl. 02. etc.) to all the spots selected. Further Spots/ 
Area/Lines can be added before clicking on OK. 





In the Results window, which was opened when you 
clicked on Analysis image, spot identification number(s) 
will be entered. Further analysis on a time-temperature 
plot basis can be activated by clicking on this line. Refer 
to the PLOT function description for further details. 
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ALIGN AND SUBTRACTION CONTROL 


MENU: IR menu - Select source - Show other manipulated 

OPTIONS: Align 

Align and subtract 
Align and mix 
Subtraction 

DESCRIPTION: 


O 


O 


The “Align and subtraction” filters both use a reference 
image. The incoming images can be shifted, turned and 
stretched by the align filter, to make them match the 
reference. The reference image can also be subtracted 
from the incoming images (in temperature) by the 
subtraction filter. Alignment and subtraction can be 
combined into one operation. Alignment can also be used 
if you want to magnify parts of an image. 

When you have made your choice, a control panel will 
show up. It enables you to select the filter you want, and 
to enter some parameter to the filter. 

You stop the manipulations by selecting another source in 
the destination IR window or by removing one of the IR 
windows. 

It is possible to specify separate level and span, object 
parameters and comment for the resulting images. The 
destination IR window can be frozen independently. 
Freezing of the input channel will also stop the image 
distribution in the recipient channel. 

It is possible to add custom designed manipulation filters. 


How to interact with the alignment filter: 

Start by fetching the Reference image to the current 
channel or “the other” one. It can be an image from 
scanner or disk etc. Store it as reference using the “Keep 
IR-x as reference” button. 


You may also start by looking at a previously stored 
reference image using the selection “Show reference 
image” of the upper arrow button. Press SET to get it 
shown. A reference image has the text “Ref image” added 
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to its name. DO NOT store it again. Display the image to 
be aligned in “the other” channel, it can also be an image 
from any source, 

Two pairs of spotmeters are used as reference points for 
the alignment. Move the two spotmeters in the reference 
image to easily identifiable positions in the object. 
Preferably as far apart as possible. (Use right mouse button 
on spot marker). 

Then move the two spotmeters in the image to be aligned 
to the corresponding points. 

Select “Process IR-x” and “Align and mix IR-x with ref* 
by the upper and lower arrow buttons on the panel and 
press SET. Then a mix of the two images will be created. 
Check the quality of the alignment. A doubling of window 
size will enable a check down to pixel level. Finetune the 
alignment by slightly moving the spotmeters in some 
image and then press the SET button again. 

When the alignment is satisfactory, select “Align IR-x 
with ref’ by the lower arrow button , press SET, and an 
aligned image will be obtained. 

You can also select “Align & subtract IR-x with ref’ and 
press SET, in which case the resulting image will be the 
aligned image with the reference image subtracted from it. 

It is now possible to align (and subtract) any number of 
images by changing Image source in the input(other) 
channel. 

Resulting images can be saved using the functions Store 
Image or Store Sequence in the output channel. 

Please note that the alignment filter creates real images. If 
you store images when the reference image or the mix is 
displayed, then these images will be stored, however odd 
it may seem. 

If you want to use a different reference image, bring it into 
one 
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of the channels and press “Keep IR-X as reference” 
button. This only stores the reference, not activates it. In 
order to make the new reference work, you have to select 
Process IR-x” again with the same sub-selection as before, 
and press SET. 
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ALIGN SCANNER 


MENU: IR menu - Select source 

OPTIONS: 


o 


DESCRIPTION: 


The purpose of the Align Scanner function is to enable a 
live scanner image to be geometrically aligned to a 
Reference image. 


O 


Alignment is the basis for automatic comparisons of the 
scanner images to other images by subtraction and for 
automatic measurement using stored analysis functions. 


If you already have captured some images and stored them 
on disk, you have to use another alignment function. Try 
processing them with the Align&Subtraction control 
function in the same menu. 


O 

o 


The image to align with is called a reference image. 
Display the image you want as reference in either channel. 
Any image will do. 

You can use the same scanner or another scanner or 
images stored on disk. Use the rotary knob to get good 
colours and contrast in the display. Save the reference 
image using the appropriate “Keep IR-X as ref button. 

The selections by the arrow push-button give you the 
opportunity to see the scanner image only, the reference 
image only or both with a fine or coarse chequer pattern. 

Move the scanner or object physically until you get good 
alignment, and freeze or store the image. 

The reference image is only shown on top of the scanner 
images, never interfering with them. If you store images, 
only the scanner image will be stored. No chequer pattern 
will be stored. 
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ANALOG CLOCK 


MENU: System menu - Create window 

OPTIONS: 

DESCRIPTION 


This function opens an analog clock window. This analog 
clock shows the time in the form of a normal (analogue) 
clock. If it need be set, use theSet date and lime dialog 
panel to set the time. It is usually comfortable to move the 
clock window up to the upper right comer of the screen 
after having op}ened it. 

When you use the Set date and time dialog panel, start by 
erasing the time to be changed using the Backspace 
button. 

The size of the clock window can be changed by clicking 
on the clock and using the Resize function. 
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MENU: 

OPTIONS: 

DESCRIPTION 


ANALYSE IMAGE 


IR menu 

Add Spot/Line/Area 
Isotherm handling 
Remove analysis 


Enables image analysis by means of spotmeters, lines, 
areas and isotherms. When the area option is used 
extremes, statistics, histogram and size (in mm^ or m^) of 
the line can be used for showing the temperature 
distribution along the line. The length is calculated going 
out from the set distance to the object adding the segments 
of the line to the final result, where each segment is 
calculated according to Pytagoras' theorem. 

The temperature profile shows the temperature along the 
line. The profile has a cursor as well, with which it is 
possible to read the temperature in each single point along 
the profile. By setting a mark in the profile there will be a 
crosshair in the original line in the image showing where 
the corresponding point is to be found. 

For an explanation of the various options available from 
this menu refer to the individual function descriptions: 

Add area Options: Area, Box, 

Circle, Ellipse 


Add line 

Add spots 

Isotherm handling 

Markers on/off 

Store 

Recall 

Remove analysis 
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APPEND SEQUENCE 


MENU: System menu - Auxiliary file handling 


o 


OPTIONS: 

DESCRIPTION: This function adds the images of a .SEQ file to the end of 
another .SEQ file. 


o 


o 

o 


Use the arrow keys to move the cursor within the field. 
Use the Delete or Backspace keys to delete the letters to 
change. 

The LOCATION appears with just a full stop indicating 
the current directory. Enter new directory into the field if 
you do not wish to remain at the current directory. 

The NAME field appears blank. Type the sequence name 
into the field. The sequence must be a sequence file with 
extension .SEQ 

Clicking on the LIST button brings up a window listing 
the directories available. Select a directory from the list 
and click the OK button to load this information into the 
location field of the dialog panel. 

The second LOCATION appears with just a full stop 
indicating the current directory. Enter new directory into 
the field if you do not wish to remain at the current 
directory. 

The To_NAME field appears blank. Type the name of the 
destination sequence into the field. The sequence must be 
a sequence file with extension .SEQ. 

Note that the appended images will get new numbers, 
starting after the last number of the destination sequence. 

Click the OK button in the dialog panel to append the 
source sequence to the destination sequence. If the 
destination sequence does not exist it will be created. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 
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MENU: 

OPTIONS: 

DESCRIPTION 


AUXILIARY FILE HANDLING 


System menu - Auxiliary file handling 

File transfer 
Ethernet info 
DOS copy file 
DOS convert file 
Dump image file 


In contrast to the FILE HANDLING function, the 
AUXILIARY FILE HANDLING offers some special file 
handling facilities. 

The File transfer and the Ethernet info selections deal with 
the Ethernet communication whereas the DOS copy file 
and the DOS convert file carry out the conversion of OS9 
files to/from DOS and the storage of mainly image files in 
DOS format. 

The Dump image file function writes a dump of the 
information in a given image file. 

For a closer explanation of the various options available 
from this menu refer to the individual function 
descriptions as listed in OPTIONS. 
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BACK 


MENU: 


o 


Area menu 
Clock menu 
Company label menu 
Icon menu 
Line menu 
Spot menu 

System menu - Window handling 
Window menu 


OPTIONS: 

^ DESCRIPTION 


o 


Moves the selected window or analysis function behind all 
other windows or functions. 

When BACK is selected from the WINDOW HANDLING 
menu the pointer changes to a black spot which must be 
placed within the boundary of the window to be moved to 
the back. The mouse button is then clicked and the 
window moves to the back. 

When BACK is selected from a WINDOW menu, the 
CLOCK menu or the COMPANY LABEL MENU then the 
window immediately moves to the back. 

BACK can also be selected from the AREA, LINE or 
SPOT menus. Position the window pointer on the analysis 
function marker, e.g. AROl, AR02, LIOl etc., and click 
the mouse button. The menu opens and BACK can then be 
selected. The selected analysis function marker 
immediately moves to the back of the other functions. 
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MENU: 


OPTIONS: 

DESCRIPTION 


CLOSE 


Company label menu 
Icon menu 

System menu - Window handling 
Window menu 

Window title bar - AGEMA logo 


Reduces the selected window to an ICON. The icon is a 
representation of the window. The icon can be treated in 
the same manner as any other window. 

Selecting CLOSE from the WINDOW HANDLING menu 
changes the pointer to a black spot which must be placed 
within the boundary of the window to be closed. Click the 
mouse button and the window reduces to an icon. 

When CLOSE is selected from a WINDOW menu the 
window reduces immediately to an icon. 

Clicking on the logo at the extreme left of any window 
reduces that window to an icon. 

If an icon is subsequently moved the position of the 
original window and the new location of the icon are both 
remembered by the system so that on re-opening the 
window it appears in its original position, and, on 
reclosing the window, the icon re-appears at its last 
location. 
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MENU; 

OPTIONS: 


DESCRIPTION 


COLOUR PALETTES 


Scale menu - Colour palettes 

Col rainbow 
Col rainbow inv 
Col ironbow 
Col ironbow inv 
Col 16 
Col 16 inv 
Col 10 
Col 10 inv 
Col 5 
Col 5 inv 
Black 


Enables the user to choose the colour range used in the 
image. 

COL RAINBOW and COL RAINBOW INV are 
continuous colour palettes using 112 continuous colours. 

COL IRONBOW and COL IRONBOW INV are 
continuous colour palettes using the colours Black, Blue, 
Violet, Red, Yellow and White. 

Selecting COL 16,10 or 5 displays the measurement range 
with sixteen, ten or five colours. INV indicates that the 
colour scale is inverted. 

Selecting BLACK sets the complete measurement range 
displayed in the image to black. The only thing that can be 
seen in the image if BLACK has been selected is one or 
two isotherms. 
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COMPANY LABEL 


MENU: System menu - Create window 

OPTIONS: 


o 


DESCRIPTION 


This function writes a selected text file (and a possible 
XI1 bitmap file) to a window. If you only want to see the 
bitmap you have to indicate an empty text file. 


O 


In order to get a complete company label up into a 
window on the screen, where ‘complete’ means a 
company name and a company logo or one of them only, 
you first have to prepare the company name and the 
company logo. 


The company name is prepared as a text file. This is 
preferably done by using the EDIT TEXT FILE function. 
DOS CONVERT FILE function. Store the company name 
file and go, if necessary, over to preparing the company 
logo. Do it the following way: open an OS9 window by 
clicking on OS9 in the CREATE WINDOW menu. 

When the OS9 window is opened, you can create such a 
file by using the bitmap editor ‘bitmap’, which you can 
reach now by giving the command ‘bitmap <filename>’. 
No filename gives help. Be careful not to use the same file 
name as for the company name. 


o 

o 


This command will give you a 16 x 16 points editor, with 
an extensive list of available functions beside it. By 
clicking on the mouse in this bitmap field you can paint 
the small squares black one by one, thus creating a copy of 
the company logo. Store the logo by getting out of the 
function by selecting the appropriate exit function. Ignore 
the possible warning text saying something like “cannot 
delete filename.BAK”. 


During the bitmap editing there is a small picture of the 
logo in the lower right comer of the window. 

Having done this, leave the OS9 window by removing it. 
Click on the window top line and select Remove. 
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Call up the Company label function, find the correct 
company name file and the prepared company logo file, 
write the respective names into the dialog panel. This will 
produce a window with the company logo to the left and 
the company name to the right of the logo. 

o 




O 


O 
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COPY FILE 


MENU: System menu - File handling 

OPTIONS: 


DESCRIPTION 

o 


Enables the user to copy selected files to another directory 
or copy them using new file names. 


On selecting COPY HLE from the FILE HANDLING 
menu a dialog panel appears on the screen. 

The dialog panel asks for the LOCATION and NAME of 
the file to be copied and the LOCATION and NEW 
NAME of the file to copy to. 


The arrow keys are used to move the text input cursor 
within the fields and between fields. The Delete key on the 
keyboard erases the character under the cursor and the 
Backspace key erases the character to the left of the 
cursor. 


The F^OM location can be left as it appears with just a 
full stop indicating the current directory or a new directory 
can be typed. The file name is then typed into the NAME 
field. 


o 

o 


Clicking on the LIST button brings up a window listing 
the directories and files in the FROM location. If the 
NAME field contains wildcards (*, ?) only those selected 
files will be shown. Selecting a directory and file from the 
list and clicking the OK button loads this information into 
the FROM location and name fields. 

The TO location and new name fields are completed in the 
same way as the FROM fields. 

The NAME field can contain wildcards enabling more 
than one file to be copied. File extensions do not need to 
be defined in the NEW NAME field as these cannot be 
changed (e.g. an .IMG file retains its extension when 
copied whether or not its name is changed). 

Clicking on the OK button starts the copy action. 
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If the OVERWRITE button is in the "down" position an 
existing file will be overwritten. If the button is in the 
"up"position then the write action will be aborted. 

The CANCEL button cancels the copy function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the copy file function. 

If you copy to a diskette, there will be a warning text 
"Medium full" when the diskette is full. You can then w 

exchange it for an empty one and the copying process can 
continue. 


o 


o 
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COPY SEQUENCE 


MENU: System menu - Auxiliary file handling 


O 


OPTIONS: 

DESCRIPTION: The function extracts images from a .SEQ sequence file. 


o 


o 

o 


Use the arrow keys to move the cursor within the field. 

Use the Delete or Backspace keys to delete the letters to 
change. 

The LOCATION appears with just a full stop indicating 
the current directory. Enter new directory into the field if 
you do not wish to remain at the current directory. 

The NAME field appears blank. Type the sequence name 
into the field. The sequence must be a sequence file with 
extension .SEQ 

Clicking on the LIST button brings up a window listing 
the directories available. Select a directory from the list 
and click the OK button to load this information into the 
location field of the dialog panel. 

The FIRST and LAST fields are both empty. Type the 
desired start and end image number of the sequence you 
want to copy from. Note that the copied images will get 
the numbers 1, 2 and so on. 

The second LOCATION appears with Just a full stop 
indicating the current directory. Enter new directory into 
the field if you do not wish to remain at the current 
directory. 

The NEW_NAME field appears blank. Type the name of 
the destination sequence into the field. The sequence must 
be a sequence file with extension .SEQ. 

The OVERWRITE button is pressed if you want to copy 
to an existing sequence. 
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The DOS RENAME button is pressed if the target 
destination is /DOS and you want the system to rename 
the file if necessary according to DOS file naming rules. 

Click the OK button in the dialog panel will copy the 
specified sequence to the destination sequence. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 
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COPY WINDOW 


MENU: System menu - Window handling 

OPTIONS: 

DESCRIPTION 

This function makes a copy of a window. The window you 
want copied should be in the foreground, not obscured by 
any other window. 

You select the function from the Window handling menu 
on the screen background. The mouse symbol will then 
turn into a cross-hair. Move it and click on the window. If 
you want the whole screen, click on the screen 
background. 

This function is not fast. It can take 10 seconds before the 
cross-hair appears and another 20 seconds before the new 
windows displayed. 

It shows almost exactly what another window looked like 
at the time of copy. The functionality of the other window 
is not copied. Buttons will not respond and menus will not 
appear. 

If the original window was partly placed outside the 
screen, only the visible part of it is copied. 

If the original window was partly obscured by other 
windows, they will still be obscuring it in the copy. 

Due to hardware limitations some window copies will 
have funny looking data on the rightmost side. Up to three 
columns on the left side of the copy might be truncated. 
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MENU: 

OPTIONS: 


DESCRIPTION 


CREATE SUB WINDOW 


IR menu - Create subwindow 

Result table 
IR status 

Image scanner data 
Customer data 


Provides the user with further information regarding 
analysis results and the status of the IR image. 

The RESULT TABLE selection from the CREATE 
SUBWINDOW menu allows the user to recall a result 
table (for the analysis functions in an IR window) that has 
previously been removed. More than one Result Table 
window can be opened for each IR window. This enables 
the user to view selected results without scrolling. 


The ER STATUS selection from the CREATE 
SUBWINDOW menu brings up a window which lists the 
status of the following: 


Image type: 
Image size: 
Level and span: 
Level: 

Span: 

OPSC: 


Temperature or Object signal 
In pixels 

From source/Set by operator 

Value 

Value 

From source/Set by operator 
File name of palette in use 


Palette: 
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Comment: From source/Set by operator 

Scanner status: OK/Fault 

The CANCEL button removes the IR STATUS window 
from the screen. 

The HELP button brings up a help text window with 
information on the IR status list. 

Selecting IMAGE SCANNER DATA opens a window 
displaying all the scanner data for the image on screen. 

The scanner data is stored with the image. The data 
includes all scanner, lens, filter, range and calibration 
information. 

Customer data is a possibility to show data added to 
images by the customer^ The customer data is a field in the 
image definition of 100 bytes. The field "custom_data” 
inside the image could be used in anyway the customer 
wants. 

The ERIKA program makes it "easy" to add own data to 
images in rei time. The customer should then supply the 
data to add with some sort of program. The program(-s) 
should update a "mailbox" in its own speed. Latest 
contents of the "mailbox" are copied into every image 
distributed when the scanner is the active source. 

ERIKA is delivered with a program that can listen to an 
RS232 port. Data sent here in a special protocol will then 
be written into customer data. 

Details about the format of the data will be displayed on 
the ERIKA screen by selecting Customer data and then 
clicking on the Help button. The Help text which comes 
up can, if a printer is connected, also be printed onto 
paper. 
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MENU: 

OPTIONS: 


DESCRIPTION 


CREATE WINDOW 


System menu - Create window 


IR-1 - 
IR-2 

IR-1 with set-up 
IR-2 with set-up 
Analog Clock 
Digital clock 
Company label 
OS9 
X demo 


Opens the IR, Analog clock, Digital clock, Company label 
and GS9 shell windows. 

The required window is selected with the menu pointer 
and the mouse button clicked. The comer symbol then 
appears and can be positioned with the mouse at the 
required location on the screen (the comer symbol 
represents the top left corner of the window and the 
window size is shown in outline). Clicking the mouse 
button completes the action. 

Two selections are available for each IR window as 
follows: 


IR-1, IR-2 


When either of these two options is selected the IR 
window is opened using either the default set-up (if it is 
being opened for the first time) or the previous set-up 
selected under IR-1/2 with set-up. 

IR-1 with set-up, IR-2 with set-up 

When either of these two options is selected a set-up panel 
appears. The panel is separated into two sections - 
PRESENTING and TEMPERATURE UNIT. 

Two selections are available in the PRESENTING section 
- TEMPERATURE and OBJECT SIGNAL. 
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If TEMPERATURE is selected then the units of 
measurement shown on the scale in the IR window will be 
those selected in the TEMPERATURE UNIT section of 
the set-up panel. 

If OBJECT SIGNAL is selected then the units of 
measurement shown on the scale in the IR window will be 
proportional to the photon radiation after correction for the 
influence of atmosphere and object emissivity. The 
temperature unit selected will be used in dialog panels. 

One of three temperature ranges can be selected in the 
TEMPERATURE UNIT section - KELVIN, CELSIUS or 
FAHRENHEIT. 

To select an option in the set-up panel the window pointer 
is positioned over the button next to the option required 
and the mouse button clicked. An option is set when the 
button alongside it appears to have been depressed. The 
button can be de-selected by clicking on it again. 

Once the selections have been made, clicking on the OK 
button continues the action of opening the IR window 
using the set-up selected. 

The CANCEL button cancels the CREATE WINDOW 
commend and the IR window is not opened. 

The HELP button calls up the on-line Help for the 
CREATE WINDOW function. 
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DELETE DIRECTORY FILE 


MENU: System menu - File handling 

OPTIONS: 


o 


DESCRIPTION 

Deletes a directory at a selected location. The directory 
must be empty - the directory may not contain any sub¬ 
directories or files. 


o 


Selecting DELETE DIRECTORY FILE from the FILE 
HANDLING menu brings up a dialog panel requesting the 
LOCATION and NAME of the directory to be deleted. 


The LOCATION can be left as it appears with just a full 
stop indicating the current location or a new location can 
be typed. The directory name is then typed into the NAME 
field. File extensions are not allowed. 


The arrow keys are used to move the cursor within the 
fields and between fields. The Delete key on the keyboard 
erases the character under the cursor and the Backspace 
key erases the character to the left of the cursor. 

Clicking on the LIST button brings up a window listing 
the locations and directories available. Selecting a location 
from the list and clicking the OK button loads this 
information into the location field. 


o 

o 


Clicking on the OK button deletes the directory or 
subdirectory selected. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the delete directory file function. 
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DELETE FILE 


MENU: System menu - File handling 

OPTIONS: 


o 


DESCRIPTION 


Deletes a file from a specified location. 


Selecting DELETE FILE from the FILE HANDLING 
menu brings up a dialog panel requesting the LOCATION 
and NAME of the file to be deleted. 

The LOCATION can be left as it appears with just a full 
stop indicating the current location or a new location can 
be typed. The file name is then typed into the NAME 
field. The NAME field can contain wildcards enabling 
more than one file to be deleted. File extensions MUST be 
defined. 


The arrow keys are used to move the cursor within the 
fields and between fields. The Delete key on the keyboard 
erases the character under the cursor and the Backspace 
key erases the character to the left of the cursor. 

Clicking on the LIST button brings up a window listing 
the locations and files available. In order to list the 
available files the required file extension (or an asterisk * 
meaning all files) must be typed into the SELECT field in 
the LIST dialog panel. Selecting a location and/or file 
from the list and clicking the OK button loads this 
information into the relevant field/s. 


O 


Clicking on the OK button deletes the file or files selected. 

The user is then requested to confirm whether or not the 
file is to be deleted. This is the default condition with the 
CONFIRM > ALL FILES button selected (pressed). In 
case that more than one file is to be deleted then 
confirmation is requested in each case. 

If the CONFIRM - NO CONHRMATION button is 
selected (pressed) then the files will be deleted without 
any requests for confirmation. This option should be used 
with care. 








Software Reference Manual 


O 


u 

o 







Thermovision^^OO Series 


MENU: 

OPTIONS: 

DESCRIPTION: 


DELETE SEQUENCE 


System menu - Auxiliary file handling 


This function removes some of the images in a .SEQ 
sequence file. 

Use the arrow keys to move the cursor within the field. 
Use the Delete or Backspace keys to delete the letters to 
change. 

The LOCATION appears with just a full stop indicating 
the current directory. Enter new directory into the field if 
you do not wish to remain at the current directory. 

The NAME field appears blank. Type the sequence name 
into the field. The sequence must be a sequence file with 
extension .SEQ 

Clicking on the LIST button brings up a window listing 
the direc tones available. Select a directory from the list 
and click the OK button to load this information into the 
location field of the dialog panel. 

The FIRST and LAST fields are both empty. Type the 
desired image numbers to be removed. If you wish to 
remove more than one part of the .SEQ file, YOU 
SHOULD START WITH THE LAST PART and proceed 
towards the beginning of the file. The reason for this is 
that the images will be renumbered, and the images after 
the deleted slot will get the numbers just deleted, thus 
causing confusion. 

Click the OK button in the dialog panel to delete the 
specified sequence. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 
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DIGITAL CLOCK 


MENU: System menu - Create window 

OPTIONS: 

DESCRIPTION 


This function opens a digital clock window. This digital 
clock shows the date and time on two lines in a window. If 
the date and/or time setting need be changed, use the Set 
date and lime dialog panel. 

When you use the Set date and time dialog panel, start by 
erasing the time to be changed using the Backspace 
button. 
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DreECTORY OF DIRECTORY FILES 


MENU: System menu - File handling 

OPTIONS: 

DESCRIPTION 


Displays a list of directories or sub-directories at a 
specified location and allows the user to select a directory 
at that location. 

Selecting DIR. OF DIR. FILES from the FILE 
HANDLING menu brings up a dialog panel requesting the 
LOCATION of the directory. 

The LOCATION can be left as it appears with just a full 
stop indicating the current location or a new location can 
be typed. 

The name of the directory required can then be typed into 
the SELECT field. 

The arrow keys are used to move the cursor within the 
fields and between fields. The Delete key on the keyboard 
erases the character under the cursor and the Backspace 
key erases the character to the left of the cursor. 

Clicking on the LIST button brings up a window listing 
the locations and directory files available. If the SELECT 
field contained an asterisk then all the available files will 
be shown. Selecting a location and/or file from the list and 
clicking the OK button loads this information into the 
relevant field/s. 

Clicking on the OK button changes the location and 
directory to that selected. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the directory of directory files function. 
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DIRECTORY OF FILES 


MENU: System menu - File handling 


OPTIONS: 


o 


DESCRIPTION 


Displays a list of files in a specified directory. 




Selecting DIRECTORY OF FILES from the FILE 
HANDLING menu brings up a dialog panel requesting the 
LOCATION of the directory. 

The LOCATION can be left as it appears with just a full 
stop indicating the current location or a new location can 
be typed. 


The name of the file required can then be typed into the 
SELECT field. 


O 

O 


The arrow keys are used to move the cursor within the 
fields and between fields. The Delete key on the keyboard 
erases the character under the cursor and the Backspace 
key erases the character to the left of the cursor. 

Clicking on the LIST button brings up a window listing 
the locations and files available. If the SELECT field 
contained an asterisk then all the available files will be 
shown. Selecting a location and/or file from the list and 
clicking the OK button loads this information into the 
relevant field/s. 

The FORMAT of the list of files shown can be chosen by 
clicking on either the NAME or TITLE buttons. With 
NAME selected the actual file names are displayed in the 
list, while with TITLE selected a title is displayed for all 
.IMG files taken from the first 30 characters of the 
comment relevant to the file. There are also other types of 
files, which can be stored with a title, e.g. files for storage 
of an analysis situation. When this function is applied to 
those files and the TITLE button is selected, then those 
titles will be displayed as well. 


Clicking on the OK button selects the file. 
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The CANCEL button cancels the function and removes 
the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the directory of files function. 

o 


O 
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MENU: 

OPTIONS: 

DESCRIPTION: 


DISPLAY PROCESSING CONTROL 


IR menu - Select source - Show other manipulated 

Mirror 

Rotate 

View 

Swcopy 

Named 


The “Display processing” filters include such operations 
as image mirroring, rotation, combined viewing and 
software copy. These filters also work with pixel values, 
not temperatures. You can use one of these filters at a 
time. There is also the option named for future additions 
of filters. 

This panel controls the selection of image filters when 
images are received from the other channel. 

The panel consists of two roll choices and a row of 
buttons. 

Select a filter with the first roll choice and select filter 
parameter with the second. Some filters do not have any 
parameters. Clicking on the SET button will activate the 
filter in the image source. 

The filler selection control panel is terminated by clicking 
on the QUIT button. Selecting an image source which 
does not receive images from the other channel will also 
terminate the filter control panel. 

Mirroring is a function which takes images from one IR 
channel, transforms them, and shows them in the 
destination channel. 


The mirror manipulation filter has one parameter X,Y or 
XY. 
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The filter function transforms positions of pixels between 
Inimage and Outimage. 

X gives mirroring in a horizontal mirror 

Y gives mirroring in a vertical mirror 

XY gives mirroring in both vertical and horizontal 
mirror (=roiate). 

The rotation filter rotates the image 180 degrees. It has no 
parameter and it is the same as mirror XY. 

View is a function which takes images from one IR 
channel, transforms them, and shows them in the 
destination channel. 

This filter builds up a new image with reduced copies of 4 
(9 or 16) images shown together, like this (4 images): 


u 

O 


oldest 



latest 


When started, the filter will just copy the current image of 
the input channel. When more images arrive, they will be 
put beside the previous images, rightwards and 
downwards, as long as there is room for them. After that, 
the new images will be shifted in at the bottom right 
comer pushing the older images back. 

The IR window will resize itself a number of times, before 
all images have been shown. 

The copies are reduced by a factor 2, 3, or 4. It is 
necessary to reduce the size of the copies, because the 
Erika system has limitations on the size of an image. 


O 

O 
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The temperatures, colours and time etc. of the constructed 
image will be those of the most recent image, which is 
marked with a red frame. If you make measurements on 
the constructed image, and go outside this frame, accuracy 
cannot be guaranteed. Unless the temperature and object 
related parameters of the copy you study are EXACTLY 
THE SAME as for the framed image. 

‘Named’ if selected will produce a question panel, where 
the LOCATION and NAME of the wanted filter is to be 
written. 

This is the normal entry for customized filters. In order to 
see whether there are any such filters in the system, select 
System menu - Equipment - Installed options. 


o 


o 
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DOS CONVERT FILE 


MENU: System menu - Auxiliary file handling 

OPTIONS: 


o 


DESCRIPTION 

In the dialog panel the following rules apply to the various 
lines. 


o 


o 


Lcx:ation: No wild cards, i.e. * or ?, can be used. 

Name: The name can have wild cards. The following 
examples show some ‘good’ narne indications: 

Imagename.img can only be ‘imagename.img’ 
Image*.img means e.g, Imagel.img, image2.img etc 
?????name.* imagename.abc mnopqname.czf etc 

Hence a ? replaces any letter or digit but not a space. The 
* replaces anything. 

A point (.) in the ‘location’ means the location indicated 
on top of the screen, e.g. /HOAJSR/ERIKA. The point is 
the default in the location when this dialog panel is 
opened. 

A great number of file types will be identified by the file 
name extension. When the file type is known, a 
conversion will always be made. If the file type is 
unknown, the file will be treated as an ASCII-file, 
provided the ‘convert unknown files to’option is 
selected.The conversion direction can be selected: 


‘Convert to DOS-format’ or 
‘Convert to OS9-format’ 

In order to copy from OS9 to DOS there must be a DOS 
formated output medium available, e.g. a diskette. The 
location of the diskette is then /DOS. 

Be prepared, for the conversion to take some time. 

Clicking on the LIST button brings up a window listing 
the directories and files in the given location. If the 







NAME field contains wildcards (*,?)only those selected 
files will be shown. Selecting a directory and file from the 
list and clicking the OK button loads this information into 
the location and name fields. 

Clicking on the OK button starts the copy action. 

If the OVERWRITE button is in the “down” position an 
existing file will be overwritten. If the button is in the 
“up” position then the write action will be aborted. 

The CANCEL button cancels the convert function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the DOS convert function. 
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DOS COPY FILE 


MENU: System menu - Auxiliary file handling 

OPTIONS: 

DESCRIPTION 


In the dialog panel the following rules apply to the various 
lines. For the ‘Copy from’ Location; No wild cards, i.e. * 
or ?, can be used. 

Name: The name can have wild cards. The following 
examples show some ‘good’ name indications: 

Imagename.img Can only be ‘imagename.img’ 
Image*.img means e.g. Imagel.img, image2.img 
etc ?????name.* imagename.abc mnopqname.czf 
etc 

Hence a ? replaces any letter or digit but not a space.The * 
replaces anything. 

A wild card in the ‘from’ name excludes any name 
indication in the ‘to’ name. 

For the ‘Copy to’: 

The ‘to’-location and ‘to’-name cannot be empty 
simultaneously. 

There must never be any wild cards in the ‘to’-name. 

A point (.) in the ‘location’ means the location indicated 
on top of the screen, e.g. /HOAJSR/ERIKA. The point is 
default in the location when this dialog panel is opened. 

If no ‘to’-name is given, the ‘to’-file will get the same 
name as the ‘from’-file. 

Tf there is a wild card (* or ?) the ‘to’-names will be the 
same as the ‘from’-names. The locations should, of course, 
be different. 

If the ‘to’-file already exists, the overwrite file option can 
be selected. 

An OS9-file name can contain up to 29 characters, but in 
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DOS, a file name only can contain 8+3 characters. If the 
DOS -rename option is selected, files will be renamed 
automatically during copy. 

A great number of file types will be identified by the file 
name extension. When the file type is known, a 
conversion will always be made. If the file type is 
unknown, the file will be treated as an ASCII-file, if the 
‘convert unknown files to’option is selected. 

The conversion direction can be selected: 

‘Convert to DOS-format’ or 
‘Convert to OS9-foimat’ 

In order to copy from OS9 to DOS there must be a DOS 
formated output medium available, e.g. a diskette. The 
location of the diskette is then /DOS. 

Be prepared, for the conversion to take some time. 

Clicking on the LIST button brings up a window listing 
the directories and files in the given location. If the 
NAME field contains wildcards (*,?) only those selected 
files will be shown. Selecting a directory and file from the 
list and clicking the OK button loads this information into 
the location and name fields. 

Clicking on the OK button starts the copy action. 

If the OVEWRWRITE button is in the “down** position an 
existing file will be overwritten. If the button is in the 
“up” position then the write action will be aborted. 

The CANCEL button cancels the convert function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the DOS convert function. 
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DUMP TO FILE 


MENU: System menu - Window handling 

OPTIONS: 


O 

o 


DESCRIPTION 

The screen dump function generates a disk file containing 
a binary copy of one or all screen windows. Several 
generally accepted PC file formats are available. 

The following formats are available: GIF, PCX and TIFF. 

The window you want dumped should be in the 
foreground, not obscured by any other window. 

You select the function from the Window handling menu 
on the screen background. Then a dialog panel comes up 
allowing you to fill in the file name and location and 
select the file format. You have to state if you want to 
point out the interesting window yourself or have the IR 1 
or IR 2 image (only) dumped. 


If you decided to point to a window, the mouse symbol 
will turn into a cross-hair. Move it and click on the 
window. If you want the whole screen, click on the screen 
background. 


o 

o 


If the OVERWRITE button is in the “down” position an 
existing file will be overwritten. If the button is in the 
“up” position then the write action will be aborted. 

This function takes time. It may take 10 seconds before 
the cross-hair appears. Dumping an entire screen to floppy 
disk takes up to 2 minutes. 

Due to hardware limitations up to three columns on the 
left side of the window dump might be truncated. 
Therefore try to avoid putting the window to be dumped to 
the extreme right. Dialog panels, icons and some menus 
cannot be dumped. Clicking on the OK button starts the 
copy action. 
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Clicking on the LIST button brings up a window listing 
the directories and files in the given location. If the 
NAME field contains wildcards (*,?) only those selected 
files will be shown. Selecting a directory and file from the 
list and clicking the OK button loads this information into 
the location and name fields. 

The CANCEL buUon cancels the convert function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the DOS convert function. 


O 

O 
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DUMP IMAGE FILE 


MENU: System menu - Auxiliary file handling 

OPTIONS: 


o 


DESCRIPTION 


The dump image window displays the contents of an 
image file except for the image itself. The window is 
made scrollable. The scrolling is controlled by the scroll 
bar on the left side of the window. 


An abbreviated description of the image file can be found 
in the Appendix to the Software Reference Manual. 

Scrolling is done by clicking with the right and left mouse 
buttons on the scroll bar. 


It is also possible to resize the dump image window to 
better view the image data. 

The window is removed by clicking on the QUIT button. 

The PRINT button will send the image data to the printer 
port. 


o 
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EDIT TEXT FILE 


MENU: System menu - File handling 

OPTIONS: 

DESCRIPTION 


Enables any text file to be edited. 

Selecting EDIT TEXT FILE from the FILE HANDLING 
menu brings up a dialog panel requesting the LOCATION 
and NAME of the file to be edited. 

The LOCATION can be left as it appears with just a full 
.stop indicating the current location or a new location can 
be typed. The file name is then typed into the NAME 
field. 

The arrow keys are used to move the cursor within the 
fields and between fields. 

Clicking on the LIST button brings up a window listing 
the directories and files available. In order to list the 
available files the required file extension (or an asterisk * 
meaning all files) must be typed into the SELECT field in 
the LIST dialog panel. Selecting a directory and file from 
the list and clicking the OK button loads this information 
into the location and name fields. 

Clicking on the OK button selects the file. 

A new window opens showing the contents of the file 
selected. Text can be input or edited using the following 
keys and commands: 

Insert Toggles between Insert and Overwrite modes. 

When Insert mode is on characters are inserted 
under the cursor and the original text moves to 
the right. 

When Overwrite mode is on the character under 
the cursor is replaced with the character typed. 

Delete In Insert mode the character under the cursor is 

erased and the characters to the right of the 
cursor move to the left. 

In Overwrite mode the ch^acter under the cursor 
is replaced with a blank and the cursor moves lo 
the right. 
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Backspace In Insert mode the character to the left of the 

cursor is erased and the characters to the right of 
the cursor move to the left. 

In Overwrite mode the character to the left of the 
cursor is replaced with a blank and the cursor 
moves to the left. 

Home Moves the cursor to the beginning of the line. 

End Moves the cursor to the last character of the line. 

PageUp The preceding page is moved into the window. 

PageDn The next page is moved into the window. 

Return Inserts a line feed at the position of the cursor. 

All characters to the right of the cursor and the 
character under the cursor are moved to a new 
line. 

Left Arrow Cursor is moved one character to the left. 

Right Arrow Cursor is moved one character to the right. 

Down arrow Cursor is moved to the corresponding character 
in the line below or to the line end. 

Up arrow Cursor is moved to the corresponding character 
in the line above or to the line end. 

Ctrl + Home In Insert mode all the characters from the 

beginning of the line to the cursor are erased. 

In Overwrite mode all the characters from the 
beginning of the line to the cursor are replaced 
with blanks. 

Ctrl + End In Insert mode all the characters from the cursor 
to the end of the line are er^ed. 

In Overwrite mode all the characters from the 
cursor to the end of the line are replaced with 
blanks are replaced with blanks. 

Ctrl + PageUpThe cursor is moved to the first character of the 
first line. 

Ctrl + PageDnThe cursor is moved to the last character of the 
last line. 

The CANCEL button cancels the function and removes 

the editing window from the screen without saving any 
changes made. 

The HELP button brings up a help text window with 
information on the edit text file function. 


o 

o 
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MENU: 

OPTIONS: 


DESCRIPTION 


EQUIPMENT 


System Menu - Equipment 

Format floppy disk 
System fitness 
Set printer port 
Set date and time 
Set background 
Screen saver on 
Screen saver off 
Interlace on 
Interlace off 
Show ERIKA version 
Installed options 


Enables the user to format a floppy disk, download 
calibration files to the scanner, check the status of 
scanners and system, set the screen mode for TV output, 
set up printer ports and view installed options, if any. 

For an explanation of the various options available from 
this menu refer to the individual function descriptions. 





Software Reference Manual 







Thermovision®^00 Series 


ETHERNET INFORMATION 


MENU: System menu - Auxiliary file handling 

OPTIONS: 


o 


DESCRIPTION 


The system Ethernet number is fixed and cannot be 
modified. 


o 


Changing the ERIKA Internet number and node name: 

1. Select “Create window” and then “OS9” from the 
main menu. 

2. Enter “set_IP_number aaa.bbb.ccc.ddd” where the 
four groups of numbers identify the Internet number. 

3. Make the new Internet number known to ERIKA as 
described below. 

4. Power OFF/ON the system. 

Making other (and own) Ethernet installations known to 

ERIKA: 


o 
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1. Change current location to/HO/ETC 

2. Select “File handling” and then “Edit text file” from 

the main menu. 

3. Enter file name: HOSTS. The editor displays the 
system HOSTS table which defines the network 
nodes reachable from this installation. Each 
definition has the format: 

Internet number Node Name 
aaa.bbb.ccc.ddd <name> [<additional name>] 

4. Append the IP number and the node name of all 
network nodes you wish to reach from ERIKA 

5. Press OK to complete the editing 

6. Select “Create window” and then “OS9” from the main 
menu 

7. Enter chd/HO/ETC 

8. Enter idbgen -x 

9. Power OFF/ON the system 
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Having the system controller connected to an ethemet 
network gives you the possibility of transferring text files 
and binary files to and from other network nodes, using 
the ftp program, and to log in to and receive logins from 
other network nodes, using the telnet program. 

The QUIT button removes the status panel from the 
screen. 


o 



o 
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MENU: 

OPTIONS: 


DESCRIPTION 


FILE HANDLING 


System menu - File handling 

Set location 
Directory of files 
Copy file 
Rename file 
Move file 
Delete file 
Dir. of dir. files 
Make directory file 
Delete directory file 
Print file 
Edit text file 


Enables operations to be performed on the various 
directories, sub-directories and files of the ERIKA system. 

For an explanation of the various options available from 
this menu refer to the individual function descriptions as 
listed in Options. 
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FILE TRANSFER 


MENU: System menu - Auxiliary file handling 

OPTIONS: 

DESCRIPTION 

o 

This utility is used to transfer files to and from remote 
systems via ethemet. There are many FTP commands to 
facilitate file transfer between systems. 

FTP is the user interface to the ARPANET standard File 
vy Transfer Protocol. FTP transfers files to and from a remote 

network site. 

Selecting the file transfer function in ERIKA brings up a 
window with a FTP command interpreter. A current status 
report is displayed of the FTP modes. FTP now awaits 
instructions from the user. When FTP is awaiting 
commands it displays the prompt ”ftp>’\ Initially, no 
connection is established to any remote system. Enter 
“connect <host-name>” or “connect ###.###.###,###” to 
establish a connection to an FTP server on the remote 
host. 


o 

U 


The hashmarks symbolize an internet number. You can 
enter a host name instead of the hashmarks. if it is present 
in the file /hO/ETC/HOSTS.Enter “help” to get a list of 
available commands. Enter ”help [<command-name>]” to 
get a help message about a specified command.Note that 
you can issue OS9 commands (like dir -e) on the system 
controller using the $-command. You can change the 
current directory on the system controller using the Icd- 
command. 

Note the distinction between ascii and binary transfer: 
Text files may have different linefeed markers on the 
remote system and on the system controller. When ascii 
mode is used, the linefeed markers are converted to suit 
the conversions of the system receiving the file. Binary 
mode transfers the file exactly as it is. 


Note that image files contain information stored in integer 
and floating point formats. These formats differ, 
depending on the architecture of the computer used. For 
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MENU: 

OPTIONS: 

DESCRIPTION 


FORMAT FLOPPY DISK 


System menu - Equipment 


The format utility is used to physically iniialize, verify and 
establish an initi^ file structure on a disk. All disks must 
be formatted before they can be used on an 08-9 system. 

Format reads a description of the disk from the device 
descriptor module. Default values for the number of sides, 
number of tracks, sector size and density are determined 
by the values in the descriptor. 

The format function in ERIKA prompts you to enter a 
floppy disk in the floppy driver. Press return and the 
format program will start. The format function will also 
prompt you for a disk name. The maximum length of the 
name is 32 characters. 

The function can be aborted by pressing Control-C. 

The question Format another (Y/N) will either allow you 
to format another diskette or to leave the FORMAT 
FLOPPY function. 
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MENU: 

OPTIONS: 

DESCRIPTION 


FREEZE 


IR window - Freeze button 
Keyboard - Frz 1, Frz 2 


Freezes the IR image at the moment the button or key is 
selected. The IR window button changes to read 
UNFREEZE. 

The function can be selected and de-selected from the IR 
window and/or the keyboard, i.e. the image can be frozen 
by clicking on the IR window button, unfrozen by pressing 
the relevant key on the keyboard and vice versa. 
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FROM SOURCE 


MENU: IR menu - Image base time menu 

System menu - Image comment 
Scale menu - Object parameter scaling 

- Level and span 

- Offset correction 


OPTIONS: 

DESCRIPTION 


From Source means that the above mentioned data, i.e. 

Image base time 

Image comment 

Object parameter scaling, 

Level and span and 
Offset correction, 

all of which form part of the image data, will be fetched 
from the original image displayed. This command has no 
effect if the image source is “scanner**. 

If the image source is “Recall image’* etc. then the 
mentioned data may be changed at display time, i.e. 
change of level and span. 

Selection of “From source” will reset the data to the 
values in the stored image. 

If applied to the Image base time it will let variations in 
the base time of stored images pass through into the 
system. 

If the source is a stored image, this image has once been 
stored with a set of the above mentioned data. These data 
will be used when the stored image is displayed. 

Another possibility is Keep current (see this keyword in 
the manual) where e.g. the image comment can be fetched 
from an image comment window on the screen. 
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FUNCTION KEYS 

MENU: 

OPTIONS: F7 

Shifl/F7 

DESCRIPTION 

Pressing the F7 button will push the upper window down 
under all other windows. This can be repeated over and 
over again until all windows have been rotated. 

Shifi/F7 will circulate the window front, which means that 
the bottom window is pushed front. 








Software Reference Manual 


O 



o 





Thermovision®^00 Series 


MENU: 


OPTIONS: 

DESCRIPTION 


FRONT 


Area menu 
Clock menu 
Company label menu 
Icon menu 
Line menu 
Spot menu 

System menu - Window handling 
Window menu 


Moves the selected window or analysis function in front of 
all other windows or functions. 

When FRONT is selected from the WINDOW 
HANDLING menu the pointer changes to a black spot 
which must be placed within the boundary of the window 
to be moved to the front. The mouse button is then clicked 
and the window moves to the front. 

When FRONT is selected from a WINDOW menu or the 
CLOCK menu then the window immediately moves to the 
front. 

FRONT can also be selected from the AREA, LINE or 
SPOT menus. Position the window pointer on the analysis 
function flag, e.g. AROl, AR02, LIOl etc., and click the 
mouse button. The menu opens and FRONT can then be 
selected. The selected analysis function immediately 
moves in front of the other functions. 

A window can also be moved to the front by positioning 
the pointer in the window title bar and clicking the right 
mouse button. 
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GREY PALETTES 


MENU: Scale menu 


OPTIONS: 


U 

O 


Grey cont 
Grey coni inv 
Grey 16 
Grey 16 inv 
Grey 10 
Grey 10 inv 
Grey 5 
Grey 5 inv 
Black 


DESCRIPTION 


Enables the user to choose the grey scale range used in ihe 
image. 

GREY CONT and GREY CONT INV are continuous grey 
scale palettes using 112 levels. 

Sixteen, ten or five levels of grey can be selected. INV 
indicates that the scale is inverted. 

Selecting BLACK sets the complete measurement range 
displayed in the image to black. 


o 


G 
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HELP 


MENU: Ail menus 


OPTIONS: 


o 

o 


Help facilities 
How to get started 
Predefined keyboard keys 
Mouse usage 
Rotary knob usage 
Window handling 
Menu tree usage 
Dialog panel editing 
Text editing 
Topics list 


DESCRIPTION 


Provides on-line, on-screen help on a variety of subjects. 
Help is available directly as an option from any of the 
menus listed above and can also be accessed from dialog 
panels by clicking on the HELP button. 

All help texts are displayed in a separate window. Click on 
the TOPICS button to view a list of topics. Click on a 
topic in this list and a further list of related Help texts 
appears. Click on the specific Help text title in this list to 
view the text. Click on INDEX to view an alphabetical list 
of all the Help texts. Click on the Help text title to view 
the text. 

Other texts can be selected by clicking on the relevant text 
within the window. The various subjects chosen are 
presented in a text field at the bottom of the window. By 
using the + and — buttons the operator can scroll through 
the list of texts that have been presented and reselect the 
required help text by clicking on the SHOW button. 
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The following help texts are available directly from the 
SYSTEM menu in the background: 


Help facilities: 

How to get 
started: 


Predefined 
keyboard keys: 

Mouse usage: 

Rotary 
knob usage: 

Window 

handling: 


Menu tree 
structure: 


Provides the user with an index of the 
help texts available.. 

Presents a short description of the actions 
necessary to start-up the system and 
obtain an IR image on the screen. 

Describes the functions and usage of the 
predefined function keys. 

Describes how to use the mouse and the 
mouse buttons. 

Describes the usage of the rotary knob 
and level and span keys. 

Describes the facilities available for 
handling windows on the screen, e.g. 
MOVE, RESIZE, etc.. 

Displays an overview of the menu tree. 


o 

u 


Dialog 

panel editing: 
Text editing: 
Topics list: 


Describes the actions necessary within 
dialog panels. 

Describes the text editing facilities and 
functions. 

Provides a list of all subjects for which 
help is available. 


vJ 


U 
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IMAGE BASE TIME 


MENU: IR menu 

OPTIONS: Set base 




Keep current 
From source 


DESCRIPTION: 


U 


o 

o 


Erika is equipped with facilities for absolute and relative 
presentation of the time of image creation. The point of 
zero of this relative time is determined by the “set base 
time” function and is called the current base time. 

The relative time is presented as -12:34:56.78 or 
+12:34:56.78 depending on if the current image was 
captured before or after the current base time. Values up to 
+/- 100 hours can be shown. 

Normally, the base time is set by external or keyboard 
trigs when images are captured. It is stored with the 
images for further study. It can, of course, also be set to a 
specified time. 

The relative time of creation can during image capture or 
retrieval be presented instead of the absolute time in the 
IR window, the IR results window and the plot window. 
Click on the time line of the IR window, the presentation 
unit line of the result window and in the middle of the plot 
window to get menus from which relative time can be 
selected. 

The base time can be changed during image retrieval in 
the same ways that it could be set during capture. You can 
also take the capture time of one of the images of a 
sequence and make it become the new base time for that 
sequence. The letters BT will appear on the time line of 
the IR window to indicate that the current base time is not 
the one that was stored with the images. 

In fact, all scanner images will be given a base time even 
if you do not try to give them one. The base time will be 
the time when you last selected the scanner as your IR 
source. 
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If you recall old images, that do not have any base time, 
the relative time will be presented as —:—:—.— except 
for in the plot window, which will use the time of the first 
image it receives as its own private base time. 
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IMAGE COMMENT 


MENU: 


OPTIONS: 

o 


IR menu - Image comment 
The title line in the IR image 

Edit 

Store 

Recall 

Keep current 
From source 


DESCRIPTION 

o 


Enables the user to display scanner and image data, and to 
edit and store comments with the images or sequences. 


EDIT allows the user to edit the comment related to the 
image or sequence on screen. A comment can also be 
added to an image or sequence. The comment added or 
edited is temporary and will be lost if the image is 
removed. To keep the comment with the image it must be 
stored. 


O 


STORE allows the user to store comments with images or 
sequences. The comment is stored in a separate file that is 
referenced directly within the image file. On selecting 
STORE a dialog panel appears on the screen. 

The dialog panel asks for the LOCATION and NAME of 
the file to be created. The arrow keys are used to move the 
cursor within the dialog panel fields and between fields. 
The Delete key on the keyboard erases the character under 
the cursor and the Backspace key erases the character to 
the left of the cursor. 

The LOCATION can be left as it appears with just a full 
stop indicating the current directory or a new directory can 
be typed in. The file name is then typed into the NAME 
field. 

Clicking on the LIST button brings up a window listing 
the directories and files available. In order to list the 
available files the required file extension (or an asterisk 
meaning all files) must be typed into the SELECT field in 
the LIST dialog panel. Selecting a directory and file from 
the list and clicking the OK button loads this information 








into the location and name fields in the STORE dialog 
panel. 

Clicking on the OK button starts the store action. 

If the OVERWRITE button is in the "down” position an 
existing file will be overwritten. If the button is in the "up" 
position then the write action will be aborted. 

The CANCEL button cancels the store comment function 
and removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the store comment function. 

RECALL allows the user to open a comment file which is 
then used as the temporary comment for the image or 
sequence displayed. On selecting the function a dialog 
panel appears asking for the LOCATION and NAME of 
the file to be opened. The file is selected in the same way 
as described ateve for the STORE function. 

KEEP COMMENT allows the operator to use the current 
comment as a temporary default comment for all 
successive images. 

FROM SOURCE recalls the original comment stored with 
the image file. 

C appears in the status section of the IR window when the 
comment is not from the source. 
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INSTALLED OPTIONS 


MENU: System menu - Equipment 

OPTIONS: 

DESCRIPTION 

Clicking on the function will bring up a file listing 
window where the installed options, if any, will be 
listed. 
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INTERLACE ON/OFF 


MENU: System menu - Equipment 

OPTIONS: 

DESCRIPTION 


There is a light emitting diode indicating the TV interlace 
state. 

- VGA Shining green when the video output is of 
VGA type, not shining if TV-interlace is 
on. 

The way to switch between having TV-interlace off and on 
is to use the equipment menu on the screen background. 
The status diode called VGA on the front panel of the 
system controller shows the current state of the TV 
interlace. 

TV interlace should be OFF when a VGA monitor is used, 
otherwise the screen will flicker. 

TV interlace should be ON when a TV monitor is used, A 
TV monitor should be connected to the Video out contact 
on the rear side of the Systems Controller. 


TV interlace is OFF by default. 
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ISOTHERM HANDLING 


MENU: 


OPTIONS: 

o 


IR menu - Analyse image - Isotherm handling 
ISOl and IS02 buttons at the rotary knob 

Highlight above 
Highlight below 
Highlight interval 


DESCRIPTION 


O 


o 

o 


Enables two separate isotherms to be displayed in each IR 
window. 

Selecting ISOTHERM HANDLING from the ANALYSE 
IMAGE menu brings up a dialog panel with the isotherm 
selection options. Each isotherm has three selectable 
options. The user can choose to highlight all pans of the 
image with a temperature higher than a set value, lower 
than a set value or a span of temperatures below a set 
value. 

To highlight all parts with a temperature higher than a 
specific value, the specific value is entered in the text field 
ISOTHERM VALUE and then the button HIGHLIGHT 
ABOVE is clicked on. The button is then "latched" in the 
down position and any other selection is cancelled. 

To highlight all parts with a temperature below a specific 
value, the value is entered into the text field ISOTHERM 
VALUE and the button HIGHLIGHT BELOW is clicked 
on. The button is then "latched" in the down position and 
any other selection is cancelled. 

To highlight parts of a specific temperature, a value must 
first be entered in the text field ISOTHERM VALUE and 
then the button HIGHLIGHT INTERVAL is clicked on. 

An interval value (span) must be entered in the text field 
alongside the HIGHLIGHT INTERVAL button. Selecting 
Highlight Interval cancels any other selection. 

Click on the ON button for the selected isotherm/s. 

Clicking on OK completes the action of setting the 
isotherms. 


Isotherms 1 and 2 highlight the selected temperatures in 






different colours (dependent on the palette chosen). Their 
positions are graphically displayed in the level and span 
bar below the image. Correspondingly there are two lines 
opened below the image with a colour box and 
information about the highlighted temperature and the 
temperature width of the isotherm. Isotherm 2 has 
graphical priority over Isotherm 1. 

The ISOTHERM VALUE can be changed without re¬ 
entering the ISOTHERM HANDLING function by using 
the IS01/IS02 keys and rotary knob. With ISOl or IS02 
selected (indicate by an LED in the key) the level of the 
isotherm value can be altered with the rotary knob. If 
HIGHLIGHT INTERVAL has been selected the user can 
toggle between the isotherm value and the span of 
temperatures for that isotherm by repeated IS01/IS02 key 
selections. 

The isotherms are removed by re-entering the ISOTHERM 
HANDLING function and setting the two dialog panel 
ON/OFF switches to OFF. The REMOVE ANALYSIS 
function in the ANALYSE IMAGE menu does not remove 
the isotherms. 

By clicking on the respective coloured boxes for the 
isotherms, a pop-up menu with the single choice Remove 
will be displayed. Clicking on Remove will remove the 
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isotherm in question. 


KEEP CURRENT 


MENU: IR menu - Image base time menu 

OPTIONS: 

DESCRIPTION 

This function “freezes” the current base time. 


o 


By selecting this function further changes in the base lime 
of stored images are prevented from penetrating into the 
system. 
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MENU: 

OPTIONS: 

DESCRIPTION 


LEVEL AND SPAN 


Keyboard - Level/span keys. Rotary knob 
Scale menu - Level and span 


Set 

Set via scale 
Auto adjust 
Keep current 
From source 


The level and span of the image in either IR window can 
be adjusted by using the LEVEL and SPAN keys in 
conjunction with the rotary knob. The active IR window is 
indicated by the LEDs in the panel above the rotary knob. 
The selected function, level or span, is indicated by an 
LED in the key. 

Selecting SPAN enables the user to adjust, with the rotary 
knob, the width of the image temperatures displayed about 
a centre value OLEVEL). Clockwise rotation increases the 
width, counter-clockwise reduces it. 

Selecting LEVEL enables the user to adjust the centre 
temperature value displayed. Clockwise rotation of the 
rotary knob raises the centre temperature value, counter¬ 
clockwise lowers it. By using the level and span 
adjustments the image temperatures displayed can be 
optimized. 

Selecting LEVEL AND SPAN from the SCALE menu 
allows the operator to select and set temporary default 
values of level and span that are used for all subsequent 
images. 

Selecting SET brings up a small dialog panel where the 
upper and lower limits of the image scale are displayed. 
These limits can be edited and by clicking on the OK 
button are entered as the new level and span values. 
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Selecting SET VIA SCALE brings up a small dialog panel 
where the upper and lower limits of the image scale are 
displayed in the same units as used in the scale menu. 
These limits can be edited and on clicking on the OK 
button are entered as the new level and span values. 

Selecting AUTO ADJUST sets the upper and lower scale 
limits automatically to the value, which is displayed in the 
dialog panel. This value comes from the source of the 
image being displayed. These values are then kept as the 
default. 

The starting default value is 100 %. Possible values range 
from 20 to 200 %, 

Selecting KEEP CURRENT sets the upper and lower scale 
limits to those currently set for the image being displayed. 
These values are then kept as the default. 

Selecting FROM SOURCE resets the level and span 
values to those of the source of the image. 

LS appears in the status section of the IR window when 
the level and span settings are not from the source. 


O 

o 


o 
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MAKE DIRECTORY FILE 


MENU: System menu - File handling 

OPTIONS: 

DESCRIPTION 

Creates a directory or sub-directory at the specified 
location. 

Selecting MAKE DIRECTORY FILE from the 
EQUIPMENT menu brings up a dialog panel requesting 
the LOCATION and NAME of the new directory. 

The LOCATION can be left as it appears with just a full 
stop indicating the current location or a new location can 
be typed. The directory name is then typed into the NAME 
field. File extensions are not allowed. 

The arrow keys are used to move between fields. 

Clicking on the LIST button brings up a window listing 
the locations and directories available. Selecting a location 
from the list and clicking the OK button loads this 
information into the location field. 

Clicking on the OK button creates a new directory or 
subdirectory either at the current location or location 
selected. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the make directory file function. 
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MENU: 

OPTIONS: 

DESCRIPTION 


MOTOR POWER OFF 


System menu - Scanner 


Clicking on any of the lines will stop the corresponding 
scanner motor. This is also possible in the Scanner control 
window. 
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MOVE 


MENU: Icon menu 

System menu - Window handling 

Area menu 

Clock menu 

Line menu 

Spot menu 

Window menu 

Company label menu 

OPTIONS; 

DESCRIPTION 


Enables the selected window or analysis function to be 
moved to a different screen or image location. 

When MOVE is selected from the WINDOW 
HANDLING menu the pointer changes to the MOVE 
symbol which must be placed within the boundary of the 
window or icon to be moved. The mouse button is then 
pressed and the window can be dragged to a different 
location on the screen. 

When MOVE is selected from a WINDOW menu, an 
ICON menu or the CLOCK menu then the window pointer 
changes to the MOVE symbol and the window may then 
be dragged to the new location. 

MOVE can also be selected from the AREA, LINE or 
SPOT menus. The window pointer is positioned on the 
analysis function marker, e.g. AROl, AR02, LIOl etc., 
and the mouse button clicked. The menu opens and 
MOVE can be selected. The selected analysis function is 
then moved to a new position in the IR image by clicking 
on any point close to the spot, line or area and dragging. 
Clicking on the OK button completes the move operation. 

A window can also be moved by positioning the pointer 
in the window title bar and pressing the right mouse 
button. The window is then dragged to the new location 
and automatically moves to the front. 
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MOVE FILE 


MENU: System menu - File handling 

OPTIONS: 


o 


DESCRIPTION 


Moves one or more selected files from the specified 
location to another location. 


On selecting MOVE FILE from the FILE HANDLING 
menu a dialog panel appears on the screen. 

The dialog panel asks for the LOCATION and NAME of 
the file to be moved and the LOCATION to move the file 
to. 


The arrow keys are used to move the cursor within the 
fields and between fields. The Delete key on the keyboard 
erases the character under the cursor and the Backspace 
key erases the character to the left of the cursor. 

The FROM location can be left as it appears with just a 
full stop indicating the current directory or a new directory 
can be typed. The file name is then typed into the NAME 
field. 


Clicking on the LIST button brings up a window listing 
the directories and files in the FROM location. If the 
NAME field contains wildcards (*, ?) only those selected 
files will be shown. Selecting a directory and file from the 
list and clicking the OK button loads this information into 
the FROM location and name fields. 


The TO location field is completed in the same way as the 
FROM location field. The TO name field cannot contain 
wildcards and must be left blank if the FROM name field 
contains wildcards. 

Clicking on the OK button starts the move action. 

The CANCEL button cancels the copy function and 
removes the dialog panel from the screen. 


The HELP button brings up a help text window with 
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information on the move file function. 

OBJECT PARAMETER SCALING 


MENU: Scale menu 

Spot menu 
Line menu 
Area menu 

OPTIONS: Edit 

Store 
Recall 
Ecalc 

Keep current 
From source 

DESCRIPTION 

An object parameter set (OP) is a set of values related to 
an object in an IR image and its surroundings. 

They are: 

- Emissivity of the object 

- Distance to the object 

- Atmospheric temperature 

- Ambient temperature (surrounding walls etc) 

- Calculated transmission (from distance and humidity) 

- Estimated transmission (overrides the calculated one) 

- Relative humidity of the atmosphere (air assumed) 

Erika can use many object parameter sets simultaneously. 
One set is used for scaling, i.e. determining the scale 
temperatures and colours of each image. It is called OPSC. 





The other object parameter sets are used by the analysis 
functions while calculating their measurement values. By 
default, OPSC is used by the analysis too. 

The result window shows the name of the object parameter 
set in use for each analysis function. 


These analysis object parameter sets are called OP + the 
name of the analysis function to which they belong, for 
instance OPSPOl for the object parameter set for 
Spotmeter 1, OPAR05, OPLI13 etc. 

You can create an OPSPOl by clicking on Edit in the “Obj 
Par” submenu of the Symbol menu of SPOT This will lead 
you to a dialog panel in which the current values for SPOl 
are shown. 

They are those of OPSC, before OPSPOl is created. 
Change some values and press OK. The values in the 
result window will be recalculated. 

The same Symbol menu offers you the possibility to store 
and recall object parameters on/from disk. 

When you want to store/recall an object parameter set, 
select Store/Recall from the menu. 

The first line to be filled out is the Title line. This line can 
take 30 characters of comment to this object parameter set. 

The current LOCATION is indicated by a full stop. See 
the top line for the location name. If necessary, change the 
location. The object parameter set name is to be typed into 
the NAME field. 

Clicking on the LIST button brings up a window listing 
the locations and flies available. Upon clicking on OK the 
information is loaded into the location and name fields. 
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Click on OK to store the object parameters. If the new 
object parameter set is to be stored under an already 
existing name, there will be a warning message and you 
will have to click on the “OVERWRITE EXISTING 
FILE” button. Be careful! 

The CANCEL button cancels the function without storing 
any object parameters. The dialog panel is removed from 
the screen. 

The menu also contains the selections “Use OPSC” which 
makes the function use OPSC again, “Keep current” which 
makes the current values (perhaps OPSC) become a new 
OPSPOl “Use other” which makes the function use some 
other object parameter set, for instance OPLI07. 

The analysis object parameter sets are independent of 
images. They can be bound to OPSC, which may vary 
with the images. They can also be bound to each other. 
That is very convenient when a group of analysis functions 
all work on the same object in the image. 

The analysis object parameter sets belong to the analysis, 
and are stored together with other information about the 
analysis functions when “store_analysis” is selected. This 
is the case both for total storage and storage by function. 
They will thus be recreated, including their bindings, when 
recall_analysis is selected. 

Please note that the OPSC is not stored by store_analysis. 

The analysis object parameters sets remain in use as long 
as the analysis of an IR channel is active. 

The object parameters are used also at Object signal 
presentation. 

The only relevant object parameter for difference images 
is the object distance. The other parameters exist, but have 
no effect on the calculations. 





Software Reference Manual 


The total number of analysis object parameter sets that can 
exist at the same time is limited to 9. The limit is set by an 
environment variable (NUM_ANA_OPS#). If you need to 
raise it, please consult the help text for usrdef-environ. 

ECALC can compute the emissivity factor. If you place a 
spotmeter on a point on an object and the system shows a 
temperature that you know is incorrect, you can enter the 
correct temperature for the same point. The ECALC 
function will use these two values, the “shown” and the 
“known” temperature, to compute a new Emissivity factor. 

The rules for the two temperatures are the following: 

* The “shown” and the “known” temperatures must 
either both be higher than or both be lower than the 
Ambient Temperature. 

* The absolute difference between the “known” and 
the Ambient temj)erature must be at least: 

10 units, if measured in object signal units, or 

3 degrees, if measured in degrees Kelvin or Celsius, 
or 5 degrees, if measured in Fahrenheit. 

* The two temperatures must of course also be such 
that the new Emissivity factor is valid, i.e. falls 
between 0.01 and 1.00. 

If a valid new value can be computed from the current 
Object Parameter Set and your values for “shown” and 
“known” temp)erature, you are presented with a 
confirmation panel in which the old and new emissivity 
values are shown, along with your “known” temperature 
and the result temperature. Ideally, those two temperatures 
should be identical. However, due to rounding effects, a 
small discrepancy is common. If the result seems logical, 
click the OK button to make the new emissivity value 
replace the old one in the object parameter set. 

You should only try calculating the emissivity under stable 
conditions, such as when having a steady image from the 
scanner or a frozen replay of images from disk. 


o 
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ECALC is NOT allowed for difference images. 

In the spot, area and line menus there are two selections. 

One is Use OPSC. Selecting this choice means that the 
measurement values for the spot, area or line will be 
calculated with OPSC. 

The other choice is Use other. You can bind an analysis 
function to the object parameter set of an other analysis 
function or to OPSC (the set used for scaling). You can 
also create a new object parameter set for the analysis 
function. 

Enter the name of the object parameter set, to which you 
want to bind the analysis function. 

OPyyxx - yy = SP, AR or LI xx = 01 .. 99 

OPSC - object parameter set for the scale 

OWN - create a new set (same as “keep 
current”) 

Click on OK to perform the binding. 

The CANCEL button cancels the function. The dialog 
panel is removed from the screen. 
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H 


OFFSET CORRECTION 


MENU: Scale menu - Offset correction 


OPTIONS: 


o 


Control 

Set 

Keep current 
From source 


DESCRIPTION 


o 


o 

o 


The offset correction is meant to compensate for a 
possible offset in the scanner. With this window it is 
possible to put in a positive or negative offset, i.e. add a 
certain value to or subtract it from the digital values for 
each pixel in the images. 

\ 

Clicking on Control will display a control window. 

There are 4 buttons after the text OFFSET. The ones with 
a + or a - in them will change the offset value one unit up 
or down. The buttons with ++ or — in them will change it 
with 10 units. 


CLEAR will reset the offset value to 0. 

KEEP will write the selected value into the 

image. 

FROM SOURCE means that the offset value will be 
fetched from the actual source, 
whether a stored image or the 
scanner. 


QUIT leaves the function without making 

any changes. 

The actual Offset Correction value is displayed under the 
lower right comer of the IR image, for examples OC=7. 
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OPEN 


MENU: Icon menu 

System menu - Window handling 

OPTIONS: 

O DESCRIPTION 

Re-opens a window that has been reduced to an ICON. 

The icon is a representation of the window that has been 
closed. 

O When OPEN is selected from the WINDOW HANDLING 

menu the pointer changes to a black spot which must be 
placed within the boundary of the icon to be opened. The 
mouse button is then clicked and the window re-opens. 

When OPEN is selected from the ICON menu the window 
re-opens immediately. 


O 


o 






Software Reference Manual 


o 



o 







Thermovision^^OO Series 


OS9 


MENU: System menu - Create window 

OPTIONS: There is a long list of OS9 options available in ERIKA, 

See in the Help texts Topic OS9-utilities. 

O DESCRIPTION 


o 


By clicking on OS9 in the Create window menu an OS9 
window will open from which a number of OS9 utilities 
can be reached. Some of them have their own entries in 
this manual. See for example File transfer or Ethernet info. 

There are quite a large number of other functions available 
also. They are quite extensive to their character. Therefore 
the best way to learn more about them is to use the Help 
text system, Topic OS9-utililies. 

In OS9 there is among other things also a complete full¬ 
screen editor, OS9-umacs. 

The bitmap editor is another example of an OS9 function. 


O 


o 
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PLOT 


MENU: In the result window - The entries for the different 

functions 


OPTIONS: 

O DESCRIPTION 




o 

o 


The plot window only plots analysis results from images 
that are accepted by the acceptance function. 

The plot window plots up to six different analysis results. 
The graph is scrollable and controlled by the scroll bar 
below the plot area. Scrolling is made by clicking on the 
scroll bar with the right or left mouse button. Clicking the 
left button scrolls the contents of the window to the left, 
which means you see more on the right side, and vice 
versa. The further to the right you click, the greater the 
scrolling. REMOVE the window by clicking on the 
window top line and then selecting the Remove menu 
item. 

The most recent plot(s) are displayed in six plot labels 
below the scrollbar. The label frame has the same colour 
as the coiresponding plot curve is drawn with. The colours 
are assigned in the same order as is used for the markers in 
the IR window when spotmeters, lines, etc. are defined. 
Thus, for example if you choose to plot spotmeters no. 1,2 
and 3 (in that order), their plot curves will be displayed in 
the same colours as their markers. 

REMOVE a plot by clicking on the plot label and 
selecting the REMOVE option. 

The status label in the lower right part of the plot window 
shows plot number (since start of plot) and plot time. It 
also shows whether plotting is active or not. 





Software Reference Manual 


A popup menu is displayed if you click on the graph area 
with the right mouse button (or the left button, unless you 
have added a cursor; see below). The menu has these 
options: 

* Add cursor 

* Remove cursor 

* Store 

* Recall 

* Scaling 

* Plot on/off 

* Status 

* Abs/rel time 

* Clear all 

ADD or REMOVE a plot cursor. The cursor will display 
plot data for any plot currently in memory. After you 
have selected the ADD CURSOR menu item, you can 
position the cursor by clicking in the plot graph with the 
left mouse button. It is also possible to press and drag the 
cursor with the left mouse button. If a cursor is defined, 
the status field in the lower right comer of the plot 
window will always show data for the image that the 
cursor indicates. Otherwise, the status window always 
shows data for the image last accepted. While the cursor is 
active, you must use the right mouse button to activate the 
popup menu again. 

STORE and RECALL plot data from file. Recalling plot 
data from file will put the plot in inactive state. When a 
plot file is recalled, the x and y scaling is reset as closely 
as possible to what was used when the file was written. 

SCALING will, if selected produce a dialog panel in 
which you can change the scaling along both the y 
(=temperature) axis and the x axis (image no. or time). 
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The temperature scale can be automatic which means that 
it follows the scale in the IR window. If you prefer 
another temperature scale, you choose the Fix scale and 
specify the maximum and minimum values. Obviously, 
the max value must be higher than the min value. Along 
the X axis, you can choose between Image scale and Time 
scale. Image scale simply means that one image 
corresponds to one pixel (can be expanded to two. three or 
four pixels). Time scale means that the distance between 
two images is proportional to the difference in image 
times. Please note that in this panel you only choose the 
TYPE of X scale. The SCALE of that scale type can then 
be adjusted using the TIME SCALE or IMAGE SCALE 
buttons in the window. 

When you change between different time scales or image 
scales, the width of the part that you can see without 
scrolling will change. The center of the presented part will 
also change automatically. If the end (most recent) plots 
are visible, they will be kept in view. If the cursor (see 
below) is active and visible it will be kept in view. 
Otherwise, the center will stay where it is. 

As the plotting proceeds, the chosen time scale may 
become impossible to use. The plot window will then 
autornatically switch to a more appropriate x-scale. 

The PLOT ON/OFF menu item toggles the plot window 
between active and inactive state. When inactive (of0» 
new images are ignored, except that their scale 
information is checked if the temperature scale is set to 
Auto. 

Choosing the STATUS menu item displays some 
information about the current scaling, and if a plot file has 
just been read in, the plot file name is also shown. 

The ABS/REL TIME menu item toggles time display in 
the status label between absolute and relative time 
(regardless of whether Time scale or Image scale is chosen 
for the X scale). 








Software Reference Manual 


The CLEAR ALL menu item deletes all current plot 
values. Unlike the previous version of the plot window, 
Clear all no longer changes the active slate, so if plotting 
is active and you select clear all, plotting will continue 
when new images are received. 

Limitations for the plot handling: 

Up to 1000 values for six result values are kept in a table 
in memory at a time. By scrolling the window, you can see 
all these values. When the table becomes full, a number of 
values (usually 200) in the beginning of the table are 
deleted, and the remaining values are shifted down. These 
values are then totally lost. After this, the table will keep 
containing between 800 and 1000 plot values. 

When TIME SCALE is chosen, images MUST arrive in 
ascending lime order, if they are to be plotted! If an image 
comes in that has an earlier time than the last one, it is 
quietly ignored. This is of course not a problem, if you 
are plotting images as they arrive from the scanner, but 
can occur when you recall stored image sequences and 
play them back in reverse order, or when stored images or 
sequences are recalled out of time order. 

If you choose IMAGE SCALE, images are plotted even if 
not in chronological order, but if you switch to Time scale 
and the order is not correct, the plot will first be cleared. 

The plot window can plot values at a rate of up to 4-5 
images per second. 


o 

u 
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PRINT FILE 


MENU: System menu 

OPTIONS: 

DESCRIPTION 

Some text windows are equipped with a Print button or a 
Print menu. They can be printed on a text printer or to a 
text file. 

The easiest way to print text files is to select “print file'* in 
the File handling menu in the System menu. 

Fill in the name (with extension) and location in the dialog 
panel and click on OK. This will print the textfile on your 
printer as a background task (i.e. without locking the 
system controller) if you have connected the printer 
correctly and set the printer port parameters properly. 

The printer port parameters are set by the Set printer port 
function of the Equipment menu in the System menu. The 
same function can also be used to direct the printing to a 
file instead of to the printer. 

Several windows are equipped with a print button or a 
print menu. Press it, and the contents of the window will 
be printed as text on the device determined by the set 
printer port function just mentioned. 
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MENU: 


OPTIONS: 

DESCRIPTION 


RECALL 


Scale menu - Obj par scaling 
Plot menu 

IR menu - Image comment 
IR menu - Analyse image 
Spot menu - Object parameter set 
Line menu - Object parameter set 
Area menu - Object parameter set 
Histogram menu 
Profile menu 


ANALYSIS STATE DATA stored on disk files may be 
recalled to an IR channel. Enter the location and name of 
the analysis state file into the input fields LOCATION and 
NAME. The current location is indicated by a full stop. 
Leave as it is or write a new location name into that field. 
Enter the name of the desired file into the NAME field. 

Please note that any analysis already running may be 
redefined depending on the contents of the analysis state 
file. 

Image comments and object parameters used for scaling 
the image can also be recalled from disk in the same way 
as just mentioned. 

PLOT DATA stored on disc files may be recalled to a plot 
window. Enter the location and name of the plot file into 
the input fields LOCATION and NAME. The current 
location is indicated by a full stop. Leave as it is or write a 
newjocation name into that. 

The LIST button shows all files containing executable 
commands, which also means files containing commands 
with no relation to the analysis functions. 

Click the OK button in the dialog panel to recall an analysis 
state to an IR channel. 

The CANCEL button cancels the function and removes the 
dialog panel from the screen. 
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RECALL IMAGE(S) 


MENU: IR menu - Select Source 

OPTIONS: 


o 


DESCRIPTION 


Enables the user to recall stored images for presentation in 
the IR window. 


On selecting RECALL IMAGE(S) from the SELECT 
SOURCE menu a dialog panel appears on the screen. 

The dialog panel asks for the LOCATION and NAME of 
the file to be recalled. 


The arrow keys are used to move the cursor within the 
fields and between fields. The Delete key on the keyboard 
erases the character under the cursor and the Backspace key 
erases the character to the left of the cursor. 


The LOCATION can be left as it appears with just a full 
stop indicating the current directory or a new directory can 
be typed. The file name is then typed into the NAME field 
and can contain wildcards (*?). When the field contains 
wildcards all the matching files will be recalled as if they 
were a sequence. The matching files will be displayed if 
the LIST button is clicked. If all the files are required the 
CANCEL button must be selected to exit from the LIST 
window. The .IMG file extension is already displayed. 

If the file name is not known clicking on the LIST button 
brings up a window listing the directories and files 
available. The .IMG file extension (with an asterisk * 
meaning all files) is already loaded into the SELECT field 
in the LIST dialog panel. Selecting a directory and file from 
the list and clicking the OK button loads this information 
into the location and name fields of the dialog panel. 


Clicking on the OK button starts the recall action. The 
image recalled replaces the previous image in the IR 
window. Any changes made to that image's comments or 
parameters are lost. ENSURE that all necessary changes 
have been saved prior to using RECALL IMAGE(S). 
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The CANCEL button cancels the recall function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 

information on the Recall Image function. , , 



o 
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RECALL SEQUENCE 


MENU: TR menu - Select Source 

OPTIONS: 

Enables the user to recall stored image sequences for 
presentation in the IR window. 

On selecting RECALL SEQUENCE from the SELECT 
SOURCE menu a dialog panel appears on the screen. 

The dialog panel asks for the LOCATION and NAME of 
the file to be recalled. 

The arrow keys are used to move the cursor within the 
fields and between fields. The Delete key on the keyboard 
erases the character under the cursor and the Backspace key 
erases the character to the left of the cursor. 


O 


DESCRIPTION 


The LOCATION can be left as it appears with just a full 
stop indicating the current directory or a new directory can 
be typed. The file name is then typed into the NAME field. 
The .IMG file extension is already displayed. 

Clicking on the LIST button brings up a window listing the 
directories and files available. The .IMG file extension 
(with an asterisk * meaning all files) is already loaded into 
the SELECT field in the LIST dialog panel. Selecting a 
directory and file from the list and clicking the OK button 
loads this information into the location and name fields of 
the dialog panel. Sequence files are distinguished from 
other image files by the number inserted between the file 
name and the .IMG extension (e.g. NAME^OOOl.IMG). If a 
file other than 0001 in a sequence is selected then the image 
contained in that file will be the first to be displayed in the 
IR window. The sequence can then be stepped forward or 
backward from this image. 

This function can also handle files with the extension 
.SEQ. 

Clicking on the OK button in the dialog panel starts the 
recall action. 
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The CANCEL button cancels the recall function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the Recall Sequence function. 

The sequence recalled replaces the previous image in the 
IR window. Any changes made to that image's comments 
or parameters are lost. ENSURE that all necessary changes 
have been saved prior to using RECALL SEQUENCE. 

When the sequence has been loaded a further dialog panel 
appears with buttons resembling the keys of a video 
cassette recorder. Clicking on the required button (pressing) 
selects the function. The keys have the following functions: 

■ STOP key - Stops the replay of the sequence when 
"pressed". 

^ PLAY FORWARD - replays all images from the 
present image to the final image of the sequence. 
Replay is at approximately one image per second. 

^ PLAY BACKWARD - replays all images from the 
present image to the first image of the sequence. 
Replay is at approximately one image per second. 

^ ^ FAST FORWARD - replays from the present image 
to the last image of the sequence at high speed. 

^ ^ FAST BACKWARD - replays from the present 
image to the first image of the sequence at high 
speed. 

» TO END - Displays the last image of the sequence. 

« TO BEGINNING - Displays the first image of the 
sequence. 

+ STEP FORWARD - Steps forward one image at a 
time. 

+ ^ STEP TO END - Replays from the present image to 
the last image of the sequence calculating the results 
of any analysis functions within the images. 

STEP BACKWARD - Steps backward one image at 
a time. 

^ - STEP TO BEGINNING - Replays from the present 
image to the first image of the sequence calculating 
the results of any analysis functions within the 
images. 


O 


o 
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REFRESH SCREEN 


MENU: System menu - Window handling 

OPTIONS: 

DESCRIPTION 


Clears and reactivates the complete screen. 

On selecting REFRESH SCREEN from the WINDOW 
HANDLING menu the screen is blanked completely 
(display adaptor memory cleared). The display is then 
recreated eliminating any errors that may have occurred. 
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RELATIVE TO BASE 


MENU: Time presentation menu 

OPTIONS: 


DESCRIPTION: 

o 

o 


The IR window presents the image capture time in a line 
below the image. The information can also be shown in 
the result window. In this case it shows the relative time. 
This means that it shows the time that has elapsed since 
the base time was set + the base time. 

Example: If the base time has been set to 0:0:0 the relative 
time means the time which has elapsed since that base 
time was set. 


If the base time has been set to 10:20:30 the relative lime 
means the time which has elapsed since that base time was 
set. An image which is captured 10 seconds after the base 
time was set will get the time 10:20:40. 


O 


o 
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REMOVE 


MENU: 


O 

o 


Area menu 
Clock menu 
Histogram window 
Icon menu 
IRmenu 
Isotherm line 
Line menu 

Company label window 
Result window 
Spot menu 

System menu - Window handling 
Window menu 


OPTIONS: 

DESCRIPTION 


Removes a window or analysis function from the screen. 

When REMOVE is selected from the WINDOW 
HANDLING menu the pointer changes to a skull symbol 
which must be placed within the boundary of the window 
or icon to be removed. The mouse button is then clicked 
and the window is cleared completely from the screen. 

When REMOVE is selected from the IR menu, a 
WINDOW menu, an ICON menu or the CLOCK menu 
then the window is removed immediately. 

REMOVE can also be selected from the AREA, LINE or 
SPOT menus. The window pointer is positioned on the 
analysis function flag, e.g. AROl, AR02, LIOl etc., and the 
mouse button clicked. The menu opens and REMOVE can 
be selected. The selected analysis function and the 
corresponding results are then removed. 

Removing the IR window implies that all windows 
associated with it also will be removed. Beware! 







Software Reference Manual 


o 

o 


o 


o 








TheTTnovision®900 Series 


REMOVE ANALYSIS 


MENU: IR menu - Analyse image 

OPTIONS: 

DESCRIPTION 


Selecting REMOVE ANALYSIS from the ANALYSE 
IMAGE menu removes all analysis functions from the IR 
window. 

All areas, lines and spots are removed from the window and 
the results window is removed. Windows having been 
opened secondarily to the result window, like the histogram 
window or the profile window will be erased as well. This 
also refers to a plot window being attached to area, line or 
spot functions. The Remove Analysis function will also 
remove the isotherms. 





Software Reference Manual 




O 


o 







Thermovision®900 Series 


RENAME FILE 


MENU: System menu - File handling 

OPTIONS: 



DESCRIPTION 


Renames a selected file. 


On selecting RENAME FILE from the FILE HANDLING 
menu a dialog panel appears on the screen. 

The dialog panel asks for the LOCATION and OLD 
NAME of the file to be renamed and the NEW NAME for 
the file. 


The arrow keys are used to move the cursor within the 
fields and between fields. The Delete key on the keyboard 
erases the character under the cursor and the Backspace key 
erases the character to the left of the cursor. 


o 


The FROM location can be left as it appears with just a full 
stop indicating the current location or a new location can be 
typed. The old file name is then typed into the NAME field. 

Clicking on the LIST button brings up a window listing the 
directories and files available. In order to list the available 
files the required file extension (or an asterisk * meaning all 
files) must be typed into the SELECT field in the LIST 
dialog panel. Selecting a directory and file from the list and 
clicking the OK button loads this information into the 
FROM location and name fields. 


The NEW NAME field is completed by typing in the new 
file name. 


o 


Clicking on the OK button starts the rename action. 

The CANCEL button cancels the copy function and 
removes the dialog panel from the screen. 


The HELP button brings up a help text window with 
information on the rename file function. 
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RESHAPE 


MENU: Area menu 

Circle menu 
Ellipse menu 
Line menu 

^ OPTIONS: 

DESCRIPTION 

Enables an AREA or LINE analysis function size and/or 
shape to be modified. 

Selecting RESHAPE from the AREA or LINE menus (by 
clicking on the identification flag) brings up a dialog panel 
with the instruction "Catch edge/corner" in a text field. The 
selected analysis function changes colour to differentiate it 
from any others in the image. 

The pointer is positioned on the line or area border and the 
mouse button clicked. If a comer has been selected a small 
box highlights this point. The instruction to "Press and 
drag" then appears in the text field. The point selected is 
then dragged to its new position. The new shape is 
displayed in a different colour on the image. 

Comers can be added to a line by clicking at the desired 
point on the line. The comer can then be moved as 
described above. Comers are automatically removed if they 
become part of a straight line between their adjacent 
o comers. 

If the area selected was placed using the BOX option then it 
will remain rectangular when reshaped. 

If the area selected was place using the CIRCLE or 
ELLIPSE options they should be handled in the same way 
as the AREA option 

Clicking on OK in the dialog panel completes the Reshape 
action. 
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MENU: 

OPTIONS: 

DESCRIPTION 


RESIZE 


System menu - Window handling 
Clock menu 

Window title bar - Resize symbol 


Enables the selected window to be enlarged or reduced. 
Enlarging or reducing the window only effects the amount 
of information displayed. Enlarging a window in which all 
the information is already visible only increases the 
boundary size. 

When RESIZE is selected from the WINDOW 
HANDLING menu or the CLOCK menu the pointer 
changes to the MOVE symbol which is then placed either 
on the boundary or a corner of the window to be enlarged 
or reduced. The mouse button is then clicked and the 
window outline can be dragged to enlarge or reduce the 
window. 

The window can also be resized by positioning the pointer 
in the extreme right hand box of the title bar and pressing 
and holding the mouse button down. The pointer changes to 
the move symbol and the window can then be resized by 
dragging the pointer with the mouse. The new window size 
is outlined on the screen. Releasing the mouse button 
completes the resizing action. 

The window will be moved to the front by this operation. 

During the operation the size (in picture elements or 
characters) is shown in the top left comer of the screen. 
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MENU: 

OPTIONS: 

DESCRIPTION 


RESULTS 


Area menu - Results 
Line menu - Results 

Area menu - Results - Extremes, Statistics, 

Histogram, Size of area 
Line menu - Results - Extremes, Statistics, 

Histogram, Profile, Length 


Enables the user to display the results of area and line 
analyses in various formats. 

Selecting RESULTS from either the AREA or LINE menus 
(by clicking on the identification flag) brings up a dialog 
panel showing the options available. 


For area and line analyses the user is given the following 
options: 

Extreme values provides the minimum , the maximum 
and the difference for the measurement 
points in the area or on the line. 

Statistics provides the average, the median and the 
standard deviation for the measurement 
points in the area or on the line. The 
average value is the arithmetical 
temperature average in the area or along 
the line. If presentation unit is object 
signal, then it is the average of the signal 
values. 


Histogram provides a histogram of all the measured 
points in the area or on the line. 

Size of area provides the size of the area in mm^ or m^ 
in the result table. 
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For line analyses the user is also given the following 
option: 

Profile provides a profile of the measurements 

along the line. A cursor can then be 
placed on the profile and the 
measurement at that point is displayed. 
The cursor position is reflected in the 
image as a cross intersecting the line. 

Length provides the length of the line in mm or 

m. 

The above options are selected by clicking on the button 
next to the option required. The button is then "latched" in 
the down position. 

Clicking on OK completes the selection and the required 
results are displayed in the result window. In the case of 
the PROFILE and HISTOGRAM options a separate 
window opens showing the profile or histogram. The 
measurement span is given to the left of the window. 

A Scroll bar appears below the profile if the profile is too 
long for the window. The left and right mouse buttons are 
then used to shift the profile within the window. 

Clicking on the CURSOR button brings up a short menu 
allowing the user to ADD/MOVE or REMOVE the cursor. 

Selecting ADD or MOVE makes it possible to position the 
cursor on the profile. Clicking at a point on the profile 
positions the cursor line at that point. The cursor can be 
repositioned by clicking at another point on the profile or 
by dragging the cursor to the new position. When the 
required position of the cursor is obtained, clicking on OK 
changes the cursor line to a cross. The measurement value 
and the image coordinates at the cursor position are 
displayed in a text field below the profile. An X marker is 
also displayed at the corresponding point on the line in the 
image. 

Selecting REMOVE removes the cursor. 
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Clicking on the EXPAND button brings up a short menu 
of expansion options. The expansion value is displayed in 
a text field next to the EXPAND button. 


o 

The presentation of temperatures or object signal is 
sometimes accompanied by warnings of different kinds: 


O 


means "No value exists". This happens for instance 
when the scanner is disconnected or a value far 
outside the current calibration is found. 


*1234 means "Uncalibrated". The value is just outside the 
current calibration and may still be usable. 


o 

o 


71234 means "Unreliable". The value is not OK at the 
moment. The reason may be that the scanner is 
stabilizing after a change of aperture. 

For areas and lines there will be an * in front of the 
result if more than 10% of the individual points are 
marked with an *. 

The extreme values and the statistics can, along with the 
temperatures of spotmeters, be plotted in a separate PLOT 
window. For more information about this, see PLOT. 

In the HISTOGRAM and PROFILE menus there is a 
possibility to STORE and RECALL to/from an ASCII file 
with the histogram and/or profile information in it. 

These files are stored and recalled like any image file. See 
e.g. RECALL or STORE. 
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RUN MACRO 


MENU: Top line menu 

OPTIONS: 

DESCRIPTION: 


This function makes it possible to run a macro which has 
been written before. The function handles one command 
after the other. Should there be anything wrong with a 
command the execution of the macro will be aborted, 
unless the button IGNORE ERRORS has been clicked on. 

For writing a macro see Appendix, Command list. 

To edit the macro question panel use the arrow keys to 
move the cursor within the field. Use the Delete or 
Backspace keys to delete the letters to change. 

The LOCATION appears with just a full stop indicating 
the current directory. Type if necessary the new directory 
into the field. 

The macro name is then typed into the NAME field. 

Clicking on the LIST button brings up a window listing 
the macros available. Select a macro from the list and 
click the OK button to load this information into the 
location field of the dialog panel. 

Click the OK button in the dialog panel to start the macro. 

If you click on the IGNORE ERRORS button, the running 
of the macro will continue even if some part of it went 
wrong. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 
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SCANNER CONTENT 


MENU: System menu 

OPTIONS: 

DESCRIPTION 


Provides the user with information on scanner status 

Selecting SCANNER 1/2 CONTENT from the 
EQUIPMENT menu opens a window containing all the 
information held in the scanner. The scanner identification 
data, the number of filler cassettes and types of filters, and 
the list of lenses is displayed followed by the calibration 
data for the scanner, filters and lenses. 





Software Reference Manual 


u 

O 


o 


o 








Thermovision®900 Series 


SCANNER CONTROL 


MENU: Scanner control panel 

OPTIONS: 


, DESCRIPTION 

Enables the user to control the scanner motors and select 
filters and temperature ranges. 


o 


At start-up or when SHOW SCANNER is selected from the 
SELECT SOURCE menu the SCANNER CONTROL 
panel is opened. The following controls are available on the 
panel: 

Motor Power ON/OFF - The scanner motors can be 
switched ON or OFF by clicking on these buttons. 

Frame rate NORMAL/HIGH - Selects the scanning rate 
required for full frame or reduced frame image display. 

Filter cassette selection - Clicking repeatedly on the T 
button cycles through the filter cassettes available with the 
selected scanner. If a filter cassette other than that fitted to 
the scanner is selected the new cassette must be fitted and 
the required filter must then be selected in order for the 
cassette to align itself. 

Filters - The panel gives the user a choice of a maximum of 
five filters per cassette. Filters are selected by clicking on 
the relevant button. The temperature ranges displayed in the 
range selection buttons change as the filter selection is 
made. 


Temperature Range selection - The four different 
temperature ranges can be selected by clicking on the 
relevant buttons. The applicable temperature range is 
displayed on the button. 


The SCANNER CONTROL panel is a window with all the 
relevant functions. When not required the panel can be 
reduced to an icon. The scanner control panel can be 
removed but it will then come back automatically if the 
scanner is still the source. 
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If You have a Stirling scanner, a button for stand by is 
added. 

Stand by is: mirror motor off and Stirling cooler in low 
power mode. 

O 


O 




o 







Themiovision®900 Series 


SCANNER LOADING 


MENU: System menu 

OPTIONS: 

DESCRIPTION 

The actual scanner type and serial number is shown. Use 
the V-shaped buttons to select files to be loaded into the 
scanner PROM. A program and/or a calibration file can be 
selected. A push on OK, after file(s) selection, will display 
“Scanner loading control panel” with more information 
about selected files, before actual loading takes place. 

The CANCEL button cancels the loading function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the Scanner loading function. 

The loading of a new scanner program starts by erasing 
the old program after which the new program is loaded. 
The whole process takes around 40 minutes. It is 
extremely important that the loading process not be 
interrupted, as this will leave the scanner without any 
program in it. Hence, the scanner is dead. 


O 

o 


o 


Therefore it is vital that this function be handled with 
great care. In order to carry out the function the loading 
file must be copied from the diskett to the hard disk. It is 
recommended to erase this loading file from the hard disk 
after it has been loaded. Thereby it is impossible to 
activate the loading function and the scanner runs no risk 
of getting its programs erased. 


O 
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SCREEN SAVER ON/OFF 



o 


The screen saver will blank the screen after ten minutes to 
prevent damage to screen phosphors caused by the bum-in 
of images. 


O 

u 
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MENU: 

OPTIONS: 


DESCRIPTION 


SELECT SOURCE 


IR menu - Select source 

Show scanner 
Align scanner 
Recall image(s) 

Recall sequence 
Show other IR window 
Show other manipulated 
Time process control 
Display process control 
Align & Subtraction control 


Enables the user to select the source of the image to be 
presented in the IR window 

For an explanation of the various options available from 
this menu refer to the individual function descriptions. 
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MENU: 

OPTIONS: 


DESCRIPTION 


SET BACKGROUND 


System menu - Equipment 

Standard 
White 
Grey 
Black 
Colour 1-9 
Phase of moon 


Enables the user to choose the background colour. 

The STANDARD background is the default. 

PHASE OF MOON presents an image of the moon in its 
particular phase at the time of selection. Reselecting this 
option updates the image. 

The colours represented by Colour 1-9 are the following: 

1 Light blue 

2 Violet 

3 Yellow 

4 Light blue 

5 Red 

6 Dark blue 

7 Dark red 

8 Green 

9 Grayish blue 




Software Reference Manual 


O 

o 


o 





Thermovision®900 Series 


SET BASE TIME 


MENU: IR menu - Image base time menu 

OPTIONS: 

DESCRIPTION: 


Use the arrow keys to move the cursor within the field. 

Use the Delete or Backspace keys to delete the letters to 
change. 

The first roll choice determines which time source to use. 
Choose between user defined time, current time or image 
time. User defined time uses the input field below. 

The second roll choice will update the current image 
source to use a new image base time. If the update event is 
NOW the new reference time is effective immediately 
otherwise a control panel is started showing the image 
base time status. 

Click the OK button in the dialog panel to start the timer. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 
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MENU: 

OPTIONS: 

DESCRIPTION 


SET DATE AND TIME 


Clock menu 

System menu - Equipment 


Enables the user to change the system date and time. 

When SET DATE AND TIME is selected from either the 
EQUIPMENT or the CLOCK menus a dialog panel appears 
giving the system date and time settings. These settings can 
be edited to give the correct date and time and are entered 
into the system when the OK button is selected. 
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MENU: 

OPTIONS: 

DESCRIPTION 


SET LOCATION 


System menu - File handling 
Top line menu 


Sets the current location from which all directories and 
files are taken (the initial path). 

Selecting SET LOCATION from the FILE HANDLING 
menu brings up a dialog panel requesting the new 
LOCATION. 

The arrow keys are used to move the cursor within the 
field. The Delete key on the keyboard erases the character 
under the cursor and the Backspace key erases the character 
to the left of the cursor. 

The LOCATION appears with just a full stop indicating the 
current directory. A new directory is then typed in. 

Clicking on the LIST button brings up a window listing 
the directories available. Selecting a directory from the list 
and clicking the OK button loads this information into the 
location field of the dialog panel. A single full stop(.) 
indicates the current location. Two full stops (..) indicates 
the directory above. Three full stops (...) indicates a level 
further up. It is not possible to select a location higher than 
the device name, e.g. /hO. 

Clicking on the OK button in the dialog panel changes the 
current location to that selected. 





The CANCEL button cancels the recall function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the Recall location function. 

It is recommended always to store images under location 

/HOAJSR/subdirectory 

where ’subdirectory’ means e.g. ERIKA or COMPANY 1 
etc. 

At a possible software update all files under /HOAJSR/etc 
will be saved over to the updated version. Files under 
other locations will be deleted or changed. 
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SET PALETTE 


MENU: Scale menu 

OPTIONS: 


o 


DESCRIPTION 

Enables the user to recall a stored palette to be used as a 
temporary default. 


O 


A number of default palettes that are not shown in the select 
palette menus are stored in the /HO/ASYS/LIB directory. 
These can be recalled in the same way as other palettes. 
The user is also able to recall palettes that have been 
edited with the text edit function and stored under 
different names. 


Selecting SET PALETTE from the SCALE menu brings up 
a dialog panel requesting the LOCATION and NAME of 
the palette file to be recalled. 

The arrow keys are used to move the cursor within the 
fields and between fields. The Delete key on the keyboard 
erases the character under the cursor and the Backspace key 
erases the character to the left of the cursor. 


o 

u 


The LOCATION can be left as it appears with just a full 
stop indicating the current directory or a new directory can 
be typed. The file name is then typed into the NAME field. 
The .PAL file extension is already displayed. 

Clicking on the LIST button brings up a window listing 
the directories and files available. The .PAL file extension 
(with an asterisk * meaning all files) is already loaded into 
the SELECT field in the LIST dialog panel. Selecting a 
directory and file from the list and clicking the OK button 
loads this information into the location and name fields of 
the dialog panel. 

Clicking on the OK button in the dialog panel starts the 
recall action. 

The CANCEL button cancels the recall function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the Set Palette function. 
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SET PRINTER PORT 


MENU: System menu - Equipment 

OPTIONS: Baud rate 300 -19200 

Parity None, even, odd 

Bits 7 or 8 

^ DESCRIPTION: 



Define spool unit and physical parameters if serial port is 
used. 

The three roll selection fields define speed and format of 
a serial port defined in the lowest field. An empty field 
will not affect the port. All commonly used speeds are 
selectable. Of the possible bit formats, 8 bit no parity, 7 bit 
even parity and 7 bit odd parity are the most commonly 
used. 

The serial ports are called RS232C 1 and RS232C 2. 

It is possible to select a file as receiver of the spool output 
by entering the file name( including location) in the 
Spooler device field, e.g. ./PRINTOUT.TXT 


WARNING: If the physical parameters are set on a serial port when a 

program is reading from, or writing to the port, the 
program will stop and has to be restarted. 


o 


o 
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SHOW ERIKA VERSION 


MENU: 

OPTIONS: 


o 


DESCRIPTION 


System menu - Equipment 


Displays the version of the ERIKA software in use. 
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MENU: 

OPTIONS: 

DESCRIPTION 


SHOW OTHER IR WINDOW 


IR menu - Select Source 


Enables the user to view the same image in both IR 
windows but possibly with different parameters applied to 
each image. 

Both ER windows must be open before selecting this option. 

This option is selected in the IR window that is to receive 
the image from the other. Select SHOW OTHER IR 
WINDOW from the SELECT SOURCE menu and the 
image that is shown in the other window is displayed in 
the selected window as well. 

Different settings and parameters can then be applied to 
the images and separate analyses can be performed on 
each. The system sees the two images as separate entities. 
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MENU: 

OPTIONS: 

DESCRIPTION: 


SHOW OTHER MANIPULATED 


IR menu - Select source 

Time processing control 
Display processing control 
Align & Subtraction control 


This function takes the images from one channel, 
processes it in a filter and shows the result in the other 
window. 

As there are a substantial number of filters implemented, 
they have been parted into three groups according to the 
options above. See them for further information. 
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MENU: 

OPTIONS: 

DESCRIPTION 


SHOW SCANNER 


IR menu - Select Source 


Presents the real-time scanner image in the IR window. 

Selecting SHOW SCANNER from the SELECT SOURCE 
menu starts up the scanner, presents the image from the 
scanner in the IR window and brings up the Scanner 
Control Panel. Refer to SCANNER CONTROL for further 
information. 

The previous image is replaced with that from the scanner. 
It is recommended that this image be stored prior to 
selecting SHOW SCANNER as all previous information 
will be lost when the scanner image is loaded. 
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MENU: 

OPTIONS: 

DESCRIPTION: 


SOUND ON/OFF 


System menu - Equipment 
Sound on 
Sound off 


There are a number of situations, when a beep is heard. 
This is usually because of an operator error e.g. you have 
tried to call up a function which operates in IR window 2 
although this window is not yet opened. 

However, there exists a possibility to control whether this 
beep sound shall be heard or not. 

The length and tone pitch are controllable by commands, 
see MAKE.SOUND and CONTROL_SOUND in the 
Command list. 

By default the sound is set to frequency = 440 Hz, which 
is the so-called ‘Normal A \ The default duration of the 
beep is 1/2 second. 
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STORE 


Scale menu - Obj par scaling 
IR menu - Analyse image - Area menu 
IR menu - Analyse image - Line menu 
IR menu - Analyse image - Spot menu 
IR menu - Analyse image - Area menu - Histogram menu 
IR menu - Analyse image 
Plot menu 

OPTIONS: 

DESCRIPTION 

Individual analysis functions as well as the whole current 
set of functions can be stored on disk. 

The numbers, positions, shapes and active measurements 
are stored as macros in disk files. The isotherms are 
included. 

Select Store from the Analysis menu of the IR window in 
question if all functions are to be stored. Select Store from 
the Symbol menu of a specific Spot/Area/Line if just one 
is to be stored. Fill in the dialog panel coming up. 

Select Recall from the Analysis menu of an IR window if 
you want to recall a stored state. 

It is possible to store the analysis state of one IR channel 
and recall it to the other IR channel. 

Enter the location and name of the analysis state file into 
the input fields LOCATION and NAME. The current 
location is indicated by a full stop. Leave as it is or write a 
new location name into that field. Enter the name of the 
analysis state file into the NAME field. Optionally, enter 
file title of your own choice into the TITLE field. 

Select “Overwrite existing file” if you want to replace an 
already existing file. Select “Append to existing file” if 
you want to append the analysis state information to an 
already existing file. Append has higher priority than 
overwrite. 


o 

u 



MENU: 






Click the OK button in the dialog panel to store the 
analysis. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 

The HISTOGRAM classes of an area or a line can be 
stored on files in ASCII text format. The file will contain 
the temperature classes of the histogram along with 
corresponding percentage. 

PLOT DATA is stored on disk files. Enter the location and 
name of the plot file into the input fields LOCATION and 
NAME. The current location is indicated by a full stop. 
Leave as it is or write a new location name into that field. 
Enter the name of the plot file into the NAME field. 
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STORE IMAGE 


MENU: IR menu 

OPTIONS: 

DESCRIPTION 

Enables the user to store selected images for analysis at a 
later date. 

On selecting STORE IMAGE from the IR menu a dialog 
panel appears on the screen. 

The dialog panel asks for the LOCATION and NAME of 
the file to be stored 

The LOCATION can be left as it appears with just a full 
stop indicating the current location or a new location can be 
typed. The file name is then typed into the NAME field. 

Clicking on the LIST button brings up a window listing the 
locations and files available. Selecting a location and file 
from the list and clicking the OK button loads this 
information into the FROM location and name fields. The 
name field automatically contains the .IMG file extension. 

The arrow keys are used to move between fields. 

Clicking on the OK button starts the store image action. 

If the OVERWRITE button is in the "down" position an 
existing file will be overwritten. If the button is in the "up" 
position then the write action will be aborted. 

The CANCEL button cancels the copy function and 
removes the dialog panel from the screen. 

The HELP button brings up a help text window with 
information on the store image function. 

It is recommended always to store images under location 






/HO/USR/subdirectory 


where 'subdirectory' means e.g. ERIKA or COMPANY 1 
etc. 

At a possible software update all files under /HO/USR/etc 
will be saved over to the updated version. Files under 
other locations will be deleted or changed. 
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STORE SEQUENCE 


MENU: IRmenu 

OPTIONS: 

DESCRIPTION 


Enables the user to store selected image sequences for 
analysis at a later date. 

Selecting STORE SEQUENCE from the IR menu brings 
up a dialog panel requesting the LOCATION and NAME 
of the file to be stored. It also contains the selections for 
starting and storing the image sequence. 

The LOCATION and NAME are completed as in the 
STORE IMAGE function. 

The first option to be set is the START option. Clicking 
repeatedly on the T button cycles through the following 
choices: 

Now - Starts the sequence recording as soon as the OK 
button is clicked. 

At HH:MM:SS - Starts the sequence recording at the time 
specified. The time is entered in the text field under the 
option field. If the complete time is not entered the system 
assumes the first pair of numbers to be the hours. E.g. if 
the only the number 13 is entered the system assumes that 
the sequence is to be started at 1p.m. 

At TRIG A - Starts the sequence recording when the 
TRIG A key is pressed. 

At TRIG B - Starts the sequence recording when the 
TRIG B key is pressed. 

The next option to be set is the STORE option. Clicking 
repeatedly on the T button cycles through the following 
choices: 

High speed - Records the images at the highest speed 
possible. 

At HH:MM:SS interval - Records an image at the time 
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interval set. The time is entered in the text field under the 
option field. If the complete interval time is not entered 
the system assumes the last pair of numbers to be the 
seconds. 

At TRIG A - Records an image when the TRIG A key is 
pressed. 

At TRIG B - Records an image when the TRIG B key is 
pressed. 

The final option to be set is the UNTIL option. Clicking 
repeatedly on the T button cycles through the following 
choices: 

Forever - Records images until the limit of the storage is 
reached. 

End of images - Recording is stopped by an end of images 
signal from the source. 

HH:MM:SS duration - Recording is stopped after the 
duration set. The time is entered in the text field under the 
option field. If the complete duration time is not entered 
the system assumes the last pair of numbers to be the 
seconds. 

#### storages - Recording is stopped after the number of 
stored images set is reached. The number is entered in the 
text field under the option field. 

At TRIG A - Stops recording images when the TRIG A 
key is pressed. 

At TRIG B - Stops recording images when the TRIG B 
key is pressed. 

The KEEP text field contains the number of stored images 
to be retained. The default is ALL. If a number is entered 
in this field the system will retain that number of images 
only. This means that if further images are recorded they 
will overwrite images previously stored. The maximum 
number that can be entered is 9999. 

If the OVERWRITE button is in the "down” position an 
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existing file will be overwritten. If the button is in the "up” 
position then the write action will be aborted. 

If the button Images in one file (.SEQ) is pressed, the 
images in the sequence belong to one and the same file. 
This file format is automatically used at recording with 
full speed (burst recording). This is an option which needs 
some additional hardward as well as software. 

The sequence that is to be recorded can be appended to an 
existing file. The file LOCATION and NAME must be 
that of the existing file. The Append to existing file button 
(+) should be clicked (pressed) to enable the images to be 
added to the existing file. 

Clicking on the OK button brings up a window displaying 
the file name and the options selected. The number of 
images stored, lost and kept are displayed under the list of 
selections and are incremented as the sequence progresses. 
The number of STORED images is the total number 
stored. The number of LOST images is the total number of 
images missed or lost. The number of KEPT images is the 
total number of images retained. This will eventually 
reach the number set and will not increase. This means 
that previously stored images are being overwritten. 

When the criteria set in the dialog box have been met the 
store sequence function is complete and the images are 
stored in separate files with the format: 

NAME^OOOl.IMG. 

It is recommended always to store images under location 
/HOAJSR/subdirectory 

where 'subdirectory' means e.g. ERIKA or COMPANY 1 
etc. 

At a possible software update all files under /HOAJSR/etc 
will be saved over to the updated version. Files under 
other locations will be deleted or changed. 




Software Reference Manual 


o 

o 


o 


o 




Thermovision®900 Series 


} 


SYSTEM FITNESS 


MENU: System menu - Equipment 

OPTIONS: 


o 


DESCRIPTION 


o 


In the system fitness window you can recall some system 
messages which have been recorded since the system was 
switched on. When the function is called up the most 
recent system message comes up. 

Positive messages will cancel out previous error messages 
of the same kind instead. Thus, System fitness will say 
‘No errors reported’ when all is well. 


Click on PREVIOUS or NEXT to look at the recorded 
system messages. 

Click on the CONFIRM button to remove the window. 
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TIME PROCESSING CONTROL 


MENU: 

OPTIONS: 




IR menu • 

Recursive 

Average 

Maxmin 

Named 


Select source - Show other manipulated 
filtering 


DESCRIPTION: 

The “Time processing” filters will perform such things as 
image noise reduction by Averaging or Recursive filtering. 
They can also create fictitious images consisting of the 
maximum (hottest) or minimum (coldest) pixel values 
found. These filters work with pixel values, not 
temperatures. You can use only one of these filters at a 
time. 

This panel controls the selection of image filters when 
images are received from the other channel. 

The panel consists of two roll choices and a row of 
buttons. 


Select a filter with the first roll choice and select filter 
parameter with the second. Some filters do not have any 
parameters. Clicking on the SET button will activate the 
filter in the image source. 

The filter selection control panel is terminated by clicking 
on the QUIT button. Selecting an image source which 
does not receive images from the other channel will also 
terminate the filter control panel. 

‘Named’ if selected will produce a question panel, where 
the LOCATION and NAME of the wanted filter is to be 
written. 

This is the normal entry for customized filters. In order to 
see whether there are any such filters in the system, select 
System menu - Equipment - Installed options. 
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MENU: 

OPTIONS: 

DESCRIPTION: 


TOOLBOX 


Top line menu - Toolboxes 

IR toolbox 
Filter toolbox 
File toolbox 

Macro toolbox , 

A toolbox is a quicker and more convenient way of 
controlling the system in cases when only a few 
commands are used many times. 

A toolbox consists of a set of push buttons (tools) with 
graphical symbols on them, on a panel on the screen. The 
panel can contain up to 24 tools. Each can have an 
explanatory line of text, which is shown when the tool is 
about to be used. 

If you sweep with the mouse over the tool buttons slowly 
and look at the white field of the panel, you will see a 
short text describing what each tool does. If the white field 
is missing, the panel has been started with the “No show 
information” option. 

The buttons at the bottom are: 

QUIT which removes the panel. 

HELP which brings up this text. 

IR-1 which makes IR-1 the default IR channel for 
this toolbox and changes its colour to the 
IR-1 colour. 

' IR-2 the same but for IR-2. 

Four different toolboxes are delivered with the system. 

o IR toolbox facilitates analysis of IR 

images 

0 FILE toolbox gives direct access to file 
handling commands 

o FILTER toolbox makes it easier to manipulate 
IR images 
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o MACRO toolbox a dummy toolbox just to show 

you how to start macros from a 
toolbox. 

You start these toolboxes from the TOOLBOXES entry of 
the top line menu. The function is then mostly carried out 
directly. 

However, some toolbox functions will show a question 
panel. In such a case use the arrow keys to move the 
cursor within the field. Use the Delete or Backspace keys 
to delete the letters to change. 

The toolbox name is then typed into the NAME field. 

Clicking on the LIST button brings up a window listing 
the macros available. Select a macro from the list and 
click the OK button to load this information into the 
location field of the dialog panel. 

Click the OK button in the dialog panel to start the 
toolbox. 

If you click on the ‘Show information’ button, the toolbox 
will show information on each tool in the toolbox. 

The CANCEL button cancels the function and removes 
the dialog panel from the screen. 

There is also a possibility to define one’s own toolboxes. 

A toolbox consists of a set of push buttons (tools) with 
graphical symbols on them, on a panel on the screen. The 
layout of the panel, the symbols and the actions taken by 
the system when the buttons are pressed are determined by 
a toolbox file, with the extension “.TOB”. You can edit 
such files of your own. 

The LOCATION appears with just a full stop indicating 
the current directory. Type if necessary the new directory 
into the field. 

In practice three different types of actions exist: 
o An Erika command 
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0 An Erika macro 
0 An OS-9 command 

The panel can contain up to 24 tools. Each has to have a 
layout definition, a bitmap file for the button symbol, 
some action to take and an explanatory line of text, that 
will be shown whenthe tool is about to be used. Like this: 


o Tool index 

keyword ‘TOOL’ 

o Bitmap file name (and path) 

keyword ‘BITMAP’ 

o Tool infonnation text 

keyword ‘LABEL’ 

o Action to take 

keywords ‘COMMAND’ 
‘MACRO’ 

‘OS9’ 

‘MESSAGE’ 


The tool index must be in the range 1 - 24. 


The bitmap file name corresponds to the bitmap to be 
displayed in the tool button. The bitmap size must be 
20x20. 

Run the bitmap program from an OS9-window to create a 
new bitmap: 

BITMAP MY_BITMAP.BIT 20x20 

The tool information text will be displayed in a window in 
the toolbox control panel. Max length of this text is 25 
characters. 

All files (toolbox description file, bitmap files, macro 
files) should be found at the same location, unless the 
whole path to the bitmap and macro files is defined in the 
toolbox file. 
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A toolbox file: 

# TOOLBOX test file 

# 

TOOL : 1 

BITMAP TOOL 1.BIT 

LABEL : Set location to ERIKA 

COMMAND : SET_LOCATION LOC=^0/usr/erika 

# 

TOOL 
BITMAP 
LABEL 
MACRO 
# 

TOOL 
BITMAP 
LABEL 
OS9 
# 

TOOL : 20 

BITMAP : TOOL20.BIT 

LABEL : Quit dir of files 

ADIR 194 2 6300 


/hO/somewhere_else/TOOL 10.BIT 

Start dir of files 

ADIR 


TOOL2.BIT 
Run a nice macro 
NICE.MAC 


MESSAGE 
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The commands of the erika control language, and their 
syntax, is described in the help texts for topic Erika 
commands. 

Some useful OS9-commands is described in topic OS9- 
utilities. 

Messages should not be used without permission. 

If you want to have your own toolbox started by the 
initialization macro INIT.MAC of Erika, add a 
START_TOOLBOX command to it. 

You can also add your own toolbox to the toolbox menu, 
if you like. 
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UNLOCK INPUT 


MENU: System menu - Window handling 

OPTIONS: 

DESCRIPTION 


Returns control of window selection to the mouse. 

To the left of the resize comer of the window title bar is 
the lock input selection. Clicking on this symbol locks the 
window selection. All mouse and keyboard actions are 
performed on the locked window irrespective of the 
position of the mouse pointer. No other window can be 
selected until the locked window has been unlocked or the 
lock has been applied to another window. 

Selecting UNLOCK INPUT from the WINDOW 
HANDLING menu removes the lock from the window and 
enables window selection to be performed with the mouse. 
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MENU: 

OPTIONS: 

DESCRIPTION 


USER DEFINED MENU 


Background 


Help 


This is an example of a user defined menu. In ERIKA 3.0 
it only contains one option, which is a help text. 

This help text tells the reader about how to edit in the file 
.agwmrc 

The file .agwmrc in the home directory (/HOAJSR/ERIKA 
where you end up when the system is started) contains 
control information for the window manager of the Erika 
program, agwm. It is possible and permitted for users to 
change the content of this file at their own risk. 

In .agwmrc one can create menus containing Erika 
commands as well as OS9 commands. Clicks on the right 
mouse button on the screen background are especially 
suited for user menus. 

In case the .agwmrc file has been damaged, a copy of the 
default file exists at /hO/asys/.agwmrc Do never change 
this file!!! 

If Erika is reinstalled, or a new Erika version is installed, 
your own .agwmrc may become overwritten (destroyed). 
So in order to avoid this, save it under a separate name, 
e.g. .agwmrc.my or save it on diskette. 
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Example 

This line, if put under “Pointer Button Definitions”, will 

bind the right button on the background to menu 

“userdef’: . 

o 

Buttons = : root: f.menu “userdef’ 

You can create the new menu and enter it after the 
“System Menu Tree”, if you like: 

menu “userdef ’ 


“MY MENU” 

“My images” 

“New spot in IR-1” 

“Phase of moon” 
“Set date & time” 


f.title 

f.funkey 

“A directory command” 
f.funkey 

“ADD_SPOT IRCHAN=1, 
POS=25:25” 

!”xphoon -b” 

f.funkey 

“SET_DATE_TIME_QP” 


) 

The directory command could be: 

“DIR_OF^FILES NAME=*.IMG^OC=/HOAJSR/ 

ERIKA,LFORMAT=TITLE" 

If you want to execute more than one command, write a 
macro file and refer to it: 

“RUN^MACRO LOC=/H0AJSR/ERIKA. NAME=name.mac** 

You have to store .agwmrc on disk and select “Reread 
.agwmrc” from the menu on the top line of the screen, in 
order to apply the changes. 

This is a somewhat dangerous operation, so do it only with 
utmost care. 


O 

O 
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MENU: 

OPTIONS: 


DESCRIPTION 


WINDOW HANDLING 


System menu - Window handling 

Move 

Front 

Back 

Resize 

Remove 

Unlock input 

Open/close 

Refresh screen 

Dump to file 

Copy 


Enables operations to be performed on the windows 
presented on the screen. 

For an explanation of the various options available from 
this menu refer to the individual function descriptions. 

A quicker way to bring a window, of which there is only a 
small part visible, to the front, put the cursor onto that 
small part and press the Shift button and click with the 
right mouse button. 

It can also be moved by doing as above and then dragging 
with the mouse. 
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XDEMO 


System menu - Create window 

Xcalc 
Xlogo Ico 
Puzzle 


These functions are a small demo set from the X Window 
system. They are provided just for demonstrating a few 
things which can be done using the X Window system. 

Here follows a short ‘description’ of the provided 
functions. Try them and enjoy them. 

xcalc - scientific calculator for X ported for OS9 

xlogo - X Window System logo ported for OS9 

ico - animate an icosahedron or other polyhedron ported 
forOS9 

puzzle - 15-puzzle game for X ported for OS9 
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MENU: 

OPTIONS: 

DESCRIPTION 
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ABOUT MACROS IN THV900 


o 


o 

o 


Most functions of the Erika software can be controlled via 
the commands of the Erika command language. 

This is a brief description of all commands which are 
recognized by the Erika software. 

There are two main types of commands, dialog panel 
commands and direct commands. Dialog panel commands 
produces a popup dialog panel where the user defines the 
command parameters. The dialog panel then produces the 
corresponding direct command. The direct command is the 
second type of command which performs the command 
function. 

There are some syntax restrictions on commands. A 
command string is maximized to 200 characters. A 
command can not have more than 20 parameters (no 
command is even close to that limit) and each parameter 
can have up to 40 characters. If a parameter value contains 
spaces then the value must be quoted, e.g. ”20:20 & 30:30’* 
which defines a coordinate list. 

A few commands have parameters with subvalues. 
Parameter subvalues are separated from the parameter 
value by the character A parameter value which 
specifies external trig has a subvalue specifying which 
external trig to use, e.g. START=ETRIG/B. 

Command parameters must be separated by a comma. 
There is no comma between the command word and the 
first parameter. The commands and parameters are not 
case sensitive. 

Many command parameters have a default value. The 
dialog panel commands remember the last parameter 
values unless overridden by a new parameter value. 
Parameters with default values need not be specified if the 
user is satisfied with the value. Parameter default values 
are listed below. 
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A parameter value can start with an environment variable, 
and this is indicated by the prefix An example: 

SET_LOCATION LOC=$HOME/my_subdir 

Default value of HOME is /HO/USR/ERIKA. Environment 
variablesARE case sensitive. 

o 


There is one chapter for each command, containing its 
name,parameters, default values, function and a short 
example. 


O 


o 

o 
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COMMAND: 

PARAMETERS: 


ERIKA COMMAND LIST 

ACCEPTANCE & ACCEPTANCE QP 
IRCHAN 

IR channel number (1 or 2). 

START (optional, default = NOW) 

Start condition for acceptance control, valid conditions 
are: 

NOW - Start acceptance immediately. 

TIME - Start at a certain time. (/HH;MM:SS) 
KTRIG - Start on keyboard trig. (/A or /B) 

ETRIG - Start on external trig. (/A, /B, /C or /D) 

f 

ACCEPT (optional, default = ALL) 

Acceptance condition, valid conditions are: 

ALL - Accept all images. 

CYCLE - Accept on time interval. (/HH:MM:SS) 

KTRIG - Accept at keyboard trig. (/A or /B) 

ETRIG - Accept at external trig. (/A, /B, /C or /D) 

UNTIL (opuonal, default = FOREVER) 

Stop condition for acceptance, valid conditions are: 
FOREVER - Never stop. 

DUR - Stop after time duration. (/HH:MM:SS) 

KTRIG - Stop at keyboard trig. (/A or /B) 

- Stop at external trig. (/A, /B, /C or /D) 


ETRIG 
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n 

DESCRIPTION: 


EXAMPLE: 


An acceptance control process is started. Images are 
accepted according to the conditions given in the 
command. The acceptance control terminates at change of 
image source. If the acceptance control is not active all 
images are accepted. 


ACCEPTANCE IRCHAN=1, START=NOW, ACCEPT=CYCLE/1 :{X)» 
UNTIL=KTRIG/B 

ACCEPTANCE_QP IRCHAN=2 


O 


SEE ALSO: 


ACCEPT_ON_TRIG ACCEPT_TRIG ACCEPT_ALL 


o 
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II 


COMMAND: ACCEPT ALL 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

DESCRIPTION: 

o 

Current image source will accept all images. 

EXAMPLE: ACCEPT_ALL IRCHAN=1 

O 

SEE ALSO: ACCEPT_ON_TRIG ACCEPT_TRIG ACCEPTANCE 


o 

o 
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COMMAND: ACCEPT_ON_TRIG 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

DESCRIPTION: 


Current image source will accept images only when 
trigged. 


EXAMPLE: ACCEPT_ON_TRIG IRCHAN=2 

SEE ALSO: ACCEPT_ALL ACCEPT_TRIG ACCEPTANCE 


o 


O 

o 
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COMMAND: ACCEPT_TRIG 

PARAMETERS: IRCHAN 

IR channel number (1 or 2), 

DESCRIPTION: 


Current image source redistributes last image marked as 
“accepted”. 

EXAMPLE: ACCEPT_TRIG IRCHAN=1 

O 

SEE ALSO: ACCEPT_ON_TRIG ACCEPT_ALL ACCEPTANCE 


o 

o 
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COMMAND; 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


ADDAREA 

IRCHAN 

IR channel number (1 or 2). 

ANUM (optional) 

Area number index. If not specified the system will 
choose a free area number. 

ATYPE (optional, default=NORMAL) 

Area type (NORMAL, BOX, CIRCLE or 
ELLIPSE). 

OPNAME (optional, default=OPSC) 

Object parameter set (OPSC, OPOl, OP02 ...) 

INT (not yet implemented) 

Integration factor (for time averaging). 


The command starts the analysis and a result table if not 
already started. The area is activated as a measurement 
function. The area is limited by the coordinates defined by 
the command DEnNE_POSITION_LIST. 

If the area already exists it will transform according to the 
new area parameters and coordinates. No more than 99 
areas can be defined. 


ADD_AREA IRCHAN=1, ATYPE=CIRCLE, ANUM=3 

DEHNE.POSmON.LIST DEL.AREA AREA.FUNC 
AREA.RESULTS 
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COMMAND: ADD LINE 


PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


LNUM (optional) 

Line number index. If not specified the system will 
choose a free line number. 


OPNAME (optional, default=OPSC) 

Object parameter set (OPSC, OPOl, OP02 ...) 


INT (not yet implemented) 

Integration factor (for time averaging). 

DESCRIPTION: 

The command starts the analysis and a result table if not 
already started. The line is activated as a measurement 
function. The line is limited by the coordinates defined by 
the command DEFINE_POSITION_LIST. If the line 
already exists it will transform according to the new line 
parameters and coordinates. No more than 99 lines can be 
defined. 

o 

EXAMPLE: ADD.LINE IRCHAN= 1, LNUM=3, OPNAME=OPSC 


^ SEE ALSO: DEnNE_POSITION_LIST DEL_LINE LINE_FUNC 

LINE_RESULTS ADD_LINE_CURSOR 
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COMMAND: ADD_LINE_CURSOR 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


LNUM 

Line number index. 


o 


POS 

Line cursor position. Position is defined as X:Y. 


O 


SEGMENT (optional, default=0) 

Line segment of cursor position. First line segment 
number is 0. 


DESCRIPTION: 


Activate a line cursor. The line cursor is visible on the 
specified line in the IR window and in the line profile 
window. If the line cursor already is activated die position 
and segment number of the cursor is updated. 


EXAMPLE: 

ADD_LINE_CURSOR IRCHAN=1, LNUM=2, P0S=12:24, SEGMENT=1 


o 


SEE ALSO: ADD_LINE 


o 
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COMMAND; ADD_PLOT & ADD_PLOT_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 




NUM 

Index of desired plot window (1 - 10). 




FUNC 

Function to plot (SP01..SP99, AR01..AR99, LI01..LI99). 


PLOT 

Function result to plot. As of now only temperature 
(TEMP) for spotmeters. Lines and areas have six different 
results to plot. Minimum value (MINV), maximum value 
(MAXV), average (AVER), median (^&DI) and standard 
deviation (SDEV). 


DESCRIPTION: 


O 


A plot assignment is sent to specified plot window. There 
must be a slot in the plot window. The plot window does 
not check if the result is produced by the analysis. 


EXAMPLE: ADD_PLOT IRCHAN= 1. NUM= 1, FUNC=SP01, PLOT=TEMP 


O 


SEE ALSO: 


ADD_PLOT IRCHAN=2, NUM=1, FUNC=AR02, PLOT=MINV 

ADD_PLOT_QP IRCHAN=1, NUM=2 

DEL.PLOT STORE_PLOT RECALL_PLOT SCALE_PLOT 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


ADD SPOT 

IRCHAN 

IR channel number (1 or 2). 

SNUM (optional) 

Spot number index. If not specified the system will choose 
a free spot number. 

OPNAME (optional, default=OPSC) 

Object parameter set (OPSC, OPOl, OP02 ...) 

POS 

Syntax ”Xn:Yn Xn+l:Yn+l.” 

Xn is pixel column coordinate (from left to right) 

Yn is pixel row coordinate (from top to bottom) 

INT (not yet implemented) 

Integration factor (for time averaging). 


The command starts the analysis and a result table if not 
already started. The spot is activated as a measurement 
function. If the spot already exists it will transform 
according to the new parameters and coordinates. Up to 
99 spots can be defined. 


ADD_SPOT IRCHAN=1, POS=100:I00 


DEL.SPOT 
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COMMAND: ADJUST_LEVEL_SPAN 


PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


, DESCRIPTION: 

o 

Calculates level and span needed to include the image 
pixel values within the scale limits. If the environment 
variable AUTO^LS_PERCENTl (or 
AUTO_LS_PERCENT2 for IR channel 2) is defined it is 
^ j used as a measure of the temperature range which will fit 

into the scale. The new level and span values are sent to 
the image source. 


EXAMPLE: ADJUST_LEVEL_SPAN IRCHAN= 1 

SEE ALSO: SET^CURRENT^LEVEL^SPAN SET_ADJ_PERCENT 

RESET_LEVEL_SPAN SET_LEVEL_SPAN 


o 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


ALIGN_SCANNER 

IRCHAN 

IR channel number (1 or 2). 


Start Align Scanner control panel 


ALIGN_SCANNER IRCHAN=1 

ALIGN_SCANNER 
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O 

o 


COMMAND: ALIGNSUBIMG 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

DESCRIPTION: 

Start Align & Subtract filter control panel 

EXAMPLE: ALIGN_SUB_IMG IRCHAN=1 

SEE ALSO: IMG-MANIPUL ALIGN_SUBTR_CP ALIGN_FILTER 

MAGNIFY_BY_ALIGN SUBTR_FILTER 


o 

O' 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 


APPEND_SEQ_FILE & APPEND_SEQ_FILE_QP 

NAME 

Name of sequence to append. Must be a sequence file 
(.SEQ). 

LOC (optional, default = .) 

Directory name where the file is located. 

NEW.NAME 

Name on sequence file to which the sequence is appended. 

TO_LOC (optional, default = .) 

Name of directory where new sequence is located. 


Append an image sequence from a source directory to a 
sequence located in a destination directory. 


APPEND_SEQ_FILE NAME=S1, NEW_NAME=S2 
APPEND_SEQ_FILE_QP NAME=S1, LOC=/HO/USR 




O 
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COMMAND: AREA_FUNC 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 




ANUM 

Area number index. 




MINV 

Activate (MINV=TRUE) or deactivate (MINV=FALSE) 
area minimum value. If the parameter is not used the 
current slate prevails. 


MAXV 

Activate (MAXV=TRUE) or deactivate (MAXV=FALSE) 
area maximum value. If the parameter is not used the 
current state prevails. 


O 


DIFF 

Activate (DIFF=TRUE) or deactivate (DIFF=FALSE) the 
calculation of the difference between the maximum and 
minimum values. If the parameter is not used the current 
state prevails. 


O 


AVER 

Activate (AVER=TRUE) or deactivate (AVER=FALSE) 
area average value. If the parameter is not used the current 
state prevails. 


SDEV 

Activate (SDEV=TRUE) or deactivate (SDEV=FALSE) 
area standard deviation. If the parameter is not used the 
current state prevails. 
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MEDI 

Activate (MEDI=TRUE) or deactivate (MEDI=FALSE) 
area median value. If the parameter is not used the current 
state prevails. 


fflST 

Activate (HIST=TRUE) or deactivate (HIST=FALSE) 
area histogram. If the parameter is not used the current 
state prevails. 




FREQ (Not yet implemented) 

Activate (FREQ=TRUE) or deactivate (FREQ=FALSE) 
area frequency table. If the parameter is not used the 
current state prevails. 


METRIC 

Activate (IvffiTRIC=TRUE) or deactivate 
(METRIC=FALSE) area size. Area size is measured in 
square meters (m2) or millimeters (mm2). If the parameter 
is not used the current state prevails. 


DESCRIPTION: 


Activates or deactivates area measurements tasks. 
Deactivation of a non-existing task will not cause an error 
report. 


o 


EXAMPLE: 

AREA_FUNC IRCHAN=1, ANUM=10, MINV=TRUE, MAXV=TRUE, DIFF=TRUE 
AREA.FUNC IRCHAN=1, ANUM=1. SDEV=FALSE. MEDI=TRUE. AVER=FALSE 
AREA_FUNC 1RCHAN=1, ANUM=2, HIST=TRUE, METRIC=FALSE 



SEE ALSO: ADD_AREA AREA_RESULTS 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


AREA_RESULTS_QP 

IRCHAN 

ER channel number (1 or 2). 

ANUM 
Area number. 

EXTR (optional, default=FALSE) 

Activate area extreme values if TRUE. 

STAT (optional, default=FALSE) 

Activate area statistics if TRUE. 

HIST (optional, default=FALSE) 

Activate area histogram if TRUE. 

METRIC (optional, default=FALSE) 

Activate area metric size function if TRUE. The size of 
the area is shown in square meters (m2) or square 
millimeters (mm2). 


A dialog panel allows the operator to choose which area 
results to present in the result table. The area results are 
activated or deactivated according to the panel choices. 


AREA_RESULTS_QP IRCHAN=1, ANUM=1, EXTR=TRUE 
ADD_AREA AREA_FUNC 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


BACKUP & BACKUP_QP 

LOC 

Subtree to backup. 


DEVICE 

Device to store backup on - /mtO for tape and /dO for 
floppy. 




AFORMAT ^ 

Archive format; TAR or MIW (Microware fsave format). 


Creates a control panel from which a backup can be 
performed. 


BACKUP LOC=/HO, DEVICE=/MTO, AFORMAT=TAR 
BACKUP_QP 


RESTORE RESTORE.QP 


vJ 


U 
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COMMAND: BASE_TIME & BASE_TIME_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


TIME (optional, default = CURRENT) 

Ly 

Image base time. Valid values are: 

CURRENT = Use current image time. 

HH:MM:SS = User defined time. 

o 

UPDATE (optional, default = NOW) 

Update condition. Controls when to update image base 
time. Valid conditions are: 

NOW - Update immediately. 

KTRIG - Update on keyboard trig. (/A or /B) 

ETRIG - Update on external trig. (/A, /B, /C or /D) 


DESCRIPTION: 




A control panel is started and waits for the update event. 

If the update event is NOW base time is set at once and no 
control panel is shown. 


EXAMPLE: 

O' 


BASE_TIMEmCHAN^l, TIME=CURRENT, UPDATE=NOW 
B ASE_TIME_QP IRCHAN=2 


SEE ALSO: 


RESET_BASE_TIME SET_BASE_TIME KEEP_BASE_TIME 
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COMMAND: CHANGEJOBJPAR SET & 

CHANGE_OBJPAR_SET _QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

FUNC 

Function to change (SP01..SP99, AR01..AR99, 
LI01..LI99). 

OPNAME 

Object parameter set. (OPyyxx, OPSC or OWN; yy = SP, 
ARor LI, XX = 01..99) 

DESCRIPTION: 


This command changes object parameter set for a given 
analysis function. 


EXAMPLE: 

CHANGE_OBJPAR_SET IRCHAN=1, FUNC=SP01, OPNAME=OPAR07 
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COMMAND: COMPANYLABEL & COMPANYLABEL_QP 

PARAMETERS: NAME 

Name of text file to display in label window. 

LOC (option, default = .) 

Name of directory where text file is located. 

BITMAP 

Name of bitmap file. Bitmap is displayed left of the text. 

B1TMAP_L0C 

Name of directory where bitmap file is located. 


DESCRIPTION: 


Displays a text file and, if specified, a bitmap. 


EXAMPLE: 

COMPANY_LABEL NAME=LABEL.TXT, LOC=/HOAJSR/ER1KA 
COMPANY_LABEL_QP 


SEE ALSO: 


SHOW_TEXT REMOVE SHOW TEXT 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


CONTROL_SOUND 

VOLUME 

Loudspeaker volume: 0 -100. 


ConU'ols the loudspeaker volume. 


CONTROL.SOUND VOLUME=58 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 


COPY FILE & COPY^FILE^QP 


NAME 

Name of file(s) to copy. Wildcards and ‘?’) are 
allowed. 


LOC (optional, default = ,) 

Directory name where the file(s) is located. 

NEW_NAME (optional) 

New name on destination file. Do not define this field if 
wildcards specified in NAME. 

TO_LOC (optional, default = .) 

Name of directory where files are copied to. 

OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing file. 

DOS (optional, default = FALSE) 

Rename file according to DOS file naming rules. If TRUE 
then rename file if necessary. 


Copy one or more files from a source directory to a 
destination directory. 
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EXAMPLE: 


COPY.FILE NAME:=*.1MG, TO_LOC=/DO,OVWR=TRUE 
COPY^FILE NAME=TEST_000?.IMG. TO,LOC=/DOS, DOS=TRUE 
COPY^FILE.QP LOC=/HOAJSR 




o 
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COMMAND: 

PARAMETERS: 


COPY_SEQ FILE & COPY_SEQ^FILE_QP 

NAME 

Name of file to copy. Must be a sequence file (.SEQ). 

LOC (optional, default = .) 

Directory name where the file is located. 

BEGIN 

Start index of image sequence to copy. (1 .. 99999). 

END 

End index of image sequence to copy. (1 .. 99999). 

NEW_NAME 

Name on destination file. 

TO_LOC (optional, default = .) 

Name of directory where sequence is copied to. 

OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing sequence. 


DOS (optional, default = FALSE) 

Rename file according to DOS file naming rules. If TRUE 
then rename file if necessary. 
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DESCRIPTION; 


Copy an image sequence from a source directory to a 
destination directory. The copied images will get new 
image numbers. 


EXAMPLE: 

COPY_SEQ_FILE NAME=S 1, BEGIN=300, END=500, TO_LOC=/OPTO 
COPY_SEQ_FrLE_QP LOC=/HO/USR 
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COMMAND: CREATE_CLOCK_WINDOW 

PARAMETERS: X (optional) 

Clock window x-position. 

Y (optional) 

Clock window y-position. 

XSIZE (optional) 

Clock window width in pixels. 

YSIZE (optional) 

Clock window height in pixels. 

TYPE (opUonal, default = ANALOG) 

Clock type ANALOG or DIGITAL. 

UPDATE (optional, default = MINUTE) 

SECOND or MINUTE (only if type is ANALOG). 

DESCRIPTION; 

Start digital or analog clock window. 

EXAMPLE: 

CREATE_CLOCK_WINDOW TYPE=ANALOG, UPDATE=SECOND 
CREATE_CLOCK_WINDOW X=0, Y=100, XSIZE=100, YSIZE=100 


SEE ALSO: 


SET DATE TIME 
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COMMAND: CREATE_IRWINDOW & 

CREATE_IRWINDOW_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

PRES (optional) 

Presentation type. Choose TEMP or OBJECTSIGNAL. 

TUNIT (optional) 

Temperature type. Recognized values are KELVIN, 
CELSIUS or FAHRENHEIT 

DESCRIPTION: 


Create an IR window with corresponding IR channel. If 
parameters PRES and TUNIT are not defined the 
environment variable PRESUNIT is used to control the 
unit of presentation. 

If PRESUNIT is undefined it will default to 
OBJECTSIGNAL. 


EXAMPLE: 

CREATE_IRWINDOW IRCHAN=I, PRES=TEMP, TUNIT=KELVIN 
CREATE_IRWINDOW_QP IRCHAN=2 


SEE ALSO: 


TERMINATE.IRCHAN 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


CREATE_RESULTTAB 

IRCHAN 

IR channel number (1 or 2). 


Create an analysis result table. Normally, a result table is 
started when creating the first analysis measurement task. 
This command is mainly used to create extra result tables. 
A result table cannot be created if the analysis is inactive. 


CREATE_RESULTTAB IRCHAN=1 
START_ANALYSIS 






ERIKA Software Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 


CUSTOMDATA 


LRCHAN 

IR channel number (1 or 2), 


User defined data is formatted and presented on the 
screen. 

The data is part of the image data and distributed by the 
scanner image source. The data format file is located in 
the HOME directory and is named “.customformaf*. 

The utility function “setcustom” tells the scanner image 
source how to update the user defined data field. 


EXAMPLE: 


CUSTOMDATA IRCHAN=1 




Thennovision®^00 Series 


COMMAND: DEFINE_POSmON_LIST 

PARAMETERS: POS 

List of coordinates (Xn:Yn Xn+l:Yn+l ), 

NEW (optional, default = FALSE) 

New list flag. If TRUE then reset coordinate list, 
otherwise append to existing list. 

O DESCRIPTION: 

Define the current list of coordinates. The list is used 
when defining the shape of an area or a line. 

EXAMPLE: DEFINE_POSITION_UST POS=”0:0 10:10 10:0", NEW=TRUE 

DEHNE_POSITION_LISTPOS=*’3:4 23:0 15:8" 

SEE ALSO: ADD_AREA ADD_LINE 




O 

O 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


DEL_AREA 


IRCHAN 

IR channel number (1 or 2). 

ANUM 
Area number. 

kJ 


Delete specified area. If the area does not exist nothing 
happens. 




DEL_AREA IRCHAN=2, ANUM=11 

ADD AREA 


o 

O 
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COMMAND: DEL_LINE 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


o 


LNUM 
Line number. 


O 


DESCRIPTION: 


Delete specified line. If the line does not exist nothing 
happens. 


EXAMPLE: DEL_LINE IRCHAN=2, LNUM=32 

SEE ALSO: ADD_AREA 


o 

o 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


DEL_LINE_CURSOR 

IRCHAN 

IR channel number (1 or 2). 


LNUM 
Line number. 




Removes the line cursor from the IR window, from the 
line profile window and from the result table. Nothing 
happens if the line cursor is already removed. 


O 


DEL_LINE_CURSOR IRCHAN=1, LNUM=3 

ADD_LINE_CURSOR 


Cj 
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Thermovision®500 Series 


COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 


DEL_PLOT 


IRCHAN 

IR channel number (1 or 2). 


NUM 

Plot window number (1 - 10). 


FUNC 

Plot symbol (SP01..SP99, AR01..AR99, LI01..LI99). 


PLOT 

Plot result to remove. For spotmeter only temperature 
(TEMP), for areas and lines the choices are; minimum 
value (MINV), maximum value (MAXV), difference 
(DIFF), average (AVER), median (MEDI) and standard 
deviation (SDEV). 


A plot removal message is sent to specified plot window. 
No error report is given if the plot task does not exist. 

DEL_PLOT IRCHAN^l, NUM=1. FUNC=L109, PLOT=AVER 
DEL_PL0T1RCHAN=2, NUM=1, FUNC=SP15, PLOT=TEMP 


SEE ALSO: 


ADD_PLOT 







ERIKA Software'Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


DEL_SPOT 

IRCHAN 

IR channel number (1 or 2). 


SNUM (optional, default=first found) 
Spotmeter number. 


u 


Remove specified spotmeter. No error report if the 
spotmeter is inactive. 


o 


DEL_SPOT IRCHAN=1, SNUM=13 DEL_SPOT IRCHAN=2 


ADD_SPOT 


O 

O 
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Thermovision®^00 Series 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


DELETE_DIR & DELETE_DIR_QP 

NAME 

Name of toget directory to delete. 

LOC (optional, default = .) 

Name of directory where target directory is located. 


Delete a directory. The directory must be empty. Current 
directory cannot be deleted. 


DELETE_DIR NAME=SUBDIR, LOC=MACROS 
DELETE_DIR_QP 


SEE ALSO: 


MAKE DIR 






ERIKA Software Commands 


COMMAND: DELETE^FILE & DELETE FILE^QP 

PARAMETERS: NAME 

Name of file(s) to delete. Wildcards (**’ and *?’) are 
allowed. 

LOC (optional, default = .) 

Directory name where the file or files are located. 

CONFIRM (option, default = ALL) 

Confirm deleted files. The options are: 

- ALL : Display a control panel and interactively 

choose the rile(s) to delete. 

-NONE: Delete without confirm. 

DESCRIPTION: 

Delete one or more files from a directory. 

EXAMPLE: DELETE_FILE NAME=*.MAC. LOC=MACROS. CONnRM=ALL 

DELETE^FILE^QP NAME=FOO. CONnRM=NONE 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 


DELETE_SEQ_FILE & DELETE_SEQ_FILE_QP 


NAME 

Name of file to delete from. 


LOC (optional, default = .) 

Directory name where the sequence file is located. 


BEGIN 

Start index of image sequence to delete. (1 .. 99999). 


END 

End index of image sequence to delete. (1 .. 99999). 


Delete a sequence of images from a .SEQ file. Remaining 
images will form a new sequence and images after the 
deleted ones will get new numbers. 


EXAMPLE: 

DELETE_SEQ_FILE NAME=*.MAC, LOC=MACROS, CONFIRM=ALL 
DELETE_SEQ_FILE_QP NAME=FOO, CONFIRM=NONE 





ERIKA Software Commands 


*: . 

COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 


DIR_OF_DIR & DIR_OF_DIR_QP 

NAME 

Name of target directories to list. 

Wildcards (**’ and “?’) are allowed. 

LOC (optional, default = .) 

Name of directory where target directories are located. 

o 

Creates a window and displays directory lists. 


DIR.OF^DIR NAME=*, LOC=. 
DIR_OF_DIR_QP LOC=/DO 


o 
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Thermovision^^OO Series 


COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 


DIR_OF_FILES & DIR_OF_FILES_QP 

NAME 

Name of file(s) to list. Wildcards (‘*’ and “?’) are allowed. 

LOC (optional, default = .) 

Name of directory where the files are located. 

LFORMAT (optional, default = NAME) 

Recognized values are: 

- NAME: Show list with file names. 

- TITLE: Show list with file names and file titles. 

- DETAILED: Show list with file names and file 

attributes. 

Creates a window with a list of files (directories 
excluded). 

DIR_OF_FILES NAME=*.TXT, LOC=USR. LFORMAT=TITLE 
DIR_OF_nLES_QP LFORMAT=DETAILED 
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COMMAND: 


PARAMETERS: 


DOS^COPY & DOS^COPY_QP & 
DOS_CONVERT_QP 


NAME 

Name of file(s) to copy. Wildcards (**’ and ‘?’) are 
allowed. 


LOC (optional, default = .) 

Name of directory where the source files are located. 


NEW_NAME (optional) 

New name on destination file. Do not define this field if 
wildcards are specified in NAME. Ignored if UPSRC = 
TRUE. 


TO__LOC (optional, default = .) 

Name of directory where files are copied to. Ignored if 
UPSRC = TRUE. 


OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing file. 


DOS (optional, default = FALSE) 

Rename file according to DOS file naming rules. If TRUE 
then rename file if necessary. 







Thermovision®^00 Series 


DIRECT (optional, default = TO_DOS) 

Indicates direction of copying (TO_DOS or TO_OS9). 
Converts files according to specified direction. 


o 


CONV_ALL (optional, default = FALSE) 

Convert all files if TRUE. Unknown file types are treated 
as text files. 


O 


UPSRC (optional, default = FALSE) 

Update source files. Source files are converted and 
updated if this flag is TRUE. If TRUE then TO_LOC and 
NEW_NAME is ignored. 


DESCRIPTION: 


Converts (and copies) one or more files from a source 
directory to a destination directory. Image files changes 
extensions after conversion. (.IMG in OS9 and .IMD in 
DOS). 


EXAMPLE: 

DOS_COPY NAME=*.IMG, TO_LCX:=/DOS, DIRECT=TO_DOS, DOS=TRUE 
DOS_CONVERT_QP NAME=*.IMG, UPSRC=TRUE, LOC=. 

DOS_COPY_QP 

SEE ALSO: COPY_FILE 

o 
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COMMAND: DUMP^IMAGE & DUMP^IMAGE^QP 

PARAMETERS: NAME 

Image file name. Extension (.IMG) is added to file name if 
missing. 

LOC (optional, default = .) 

Name of directory where image file is located. 

DESCRIPTION: ^ 

The contents of the image file are presented (pixel data 
excluded) in a scrollable window. 

EXAMPLE: DUMPJMAGE NAME=NOP, LOC=/HO/AS YS/LIB 

DUMPJMAGE_QP 


O 

o 
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COMMAND: ECALC_OBJPARS & ECALC_OBJPARS_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

SHOWN 

Shown temperature for a measurement point, specified in 
the current presentation unit. 

KNOWN 

Known temperature of the same measurement point. 

CONFIRM (optional, default=YES) 

Confirm calculated emissivity factor if YES, otherwise 
NO. 

DESCRIPTION: 

Calculate a new emissivity factor on the basis of the 
temperature known by the operator and the temperature 
shown by the system. The function is connected to the 
object parameters of the scale. 

EXAMPLE: 

ECALC_OBJPARS IRCHAN=1, SHOWN=32, KNOWN=36, CONnRM=YES 


ECALC_OB JPARS_QP IRCH AN=2 







ERIKA Software' Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


EDIT_COMMENT 

IRCHAN 

IR channel number (1 or 2). 


Start an image comment editor. The editor requests the 
comment from the current image source and displays it. 
The comment may now be edited freely and after clicking 
on the OK button the new comment is sent to the image 
source. 


Vj 

o 


EDIT_COMMENT IRCHAN=1 


RESET_COMMENT KEEP_COMMENT 


O 
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Thermovision^^OO Series 


COMMAND: EDIT_OFFSET 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


o 

o 


DESCRIPTION: 


Starts a panel for offset correction control. The current 
offset is presented and can be changed by pressing 
different buttons. Each time the offset is corrected the new 
value is sent to the current image source. 


EXAMPLE: EDIT_OFFSET IRCHAN=2 


SEE ALSO: SET_OFFSET KEEP_OFFSET RESET_OFFSET 


O 

o 
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COMMAND: EDIT_OBJPARS & EDIT_OBJPARS_^QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


EPS 

Emissivity of object. 


TAO_ESt 

Estimated transmittance. If 0 then do not use this value. 


TATM 

Atmospheric temperature. 


TAMB 

Ambient temperature. 


DOBJ 

Object distance in meters. 


RELHUM 

Relative humidity in percent. 


OPNAME 

Object parameter set. (OPyyxx or OPSC; yy = SP, AR or 
LI, XX = 01 ..99 
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DESCRIPTION: 


Edit scale object parameters. Each parameter is checked 
against its limits, illegal combinations are not detected. 
The current image source is updated with the new object 
parameters. 


EXAMPLE: 

EDIT.OBJPARS IRCHAN=1, EPS=0.98, TATM=25. DOBJ=20, OPNAME^OPARl 1 
EDIT_OBJPARS_QP IRCHAN=1, RELHUM=70 


SET_CURRENT_OBJPARS RECALL_OBJPARS 


SEE ALSO: 








ERIKA SoftwareiCommands 


COMMAND; 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


EDIT_TEXT_FILE & EDIT_TEXT_FILE_QP 

NAME 

Name of text file to edit. 


LOC (optional, default = .) 

Name of directory where text file is located. 




Creates a window for text file editing. 


O 


EDIT_TEXT_FILE NAME=.LOGIN 
EDIT_TEXT_FILE_QP 


o 
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COMMAND: RLTER 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

NAME 

Name of filter file. 

LOC (optional, default = .) 

Name of directory where filter file is located. 

DESCRIPTION: 

Starts a control panel for choosing manipulating filters for 
images transferred between IR channels. 

EXAMPLE: 

FILTER IRCHAN=2, LOC=$ASYS/LIB, NAME=FILTER_A.SYS 


SEE ALSO: 


SHOW_OTHERCHAN 







ERIKA SoftwareiCommands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


FREEZE 

IRCHAN 

IR channel number (1 or 2). 

Current image source will freeze the image flow. 

FREEZE IRCHAN=1 

u 

UNFREEZE FREEZE_TOGGLE 


vJ 

O 
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Thermovision®^00 Series 


COMMAND: FREEZE_TOGGLE 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 




DESCRIPTION: 

Current image source toggles the freeze/unfreeze switch. 

EXAMPLE: FREEZE_TOGGLE IRCHAN=1 

SEE ALSO: . UNFREEZE FREEZE 


o 

o 
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ERIKA Software Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 


GETOBJPARS 

IRCHAN 

IR channel number (1 or 2). 

OPNAME (optional, default = OPSC) 

Object parameter set. (OPyyxx or OPSC; yy = SP, AR or 
LI,xx = 01..99) 


Fetch object parameters from current image source. The 
parameters are returned in the reply string of the 
command. 


EXAMPLE: 

GET_OBJPARS IRCHAN=1 
GET_OBJPARS IRCHAN=2, OPNAME=OPLI02 






Thermovision^^OO Series 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


HELPS 


SWORD (optional, default = “Topics list”) 
Search word to help utility. 


Starts help utility. 


HELPS SWORD=Area 


HELPS 







ERIKA Software Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


IMAGE_SCANNER_DATA 

IRCHAN 

IR channel number (1 or 2). 

u 

Display scanner information continuously in a scrollable 
window. 

IMAGE_SCANNER_DATA IRCHAN=1 

SCANNER_CONTENT 


U 
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Therniovision^^OO Series 


COMMAND: INTERLACE & INTERLACE_QP 

PARAMETERS: SWITCH (optional, default = OFF) 

Interlace ON or OFF. 

DESCRIPTION: 

o 

Enable or disable interlace mode. The VGA diode on the 
front panel is lighted green if interlace mode is OFF. 

EXAMPLE: INTERLACE SWITCH=OFF 

INTERLACE_QP SWITCH=ON 


o 

o 
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ERIKA Software Commands 


COMMAND: IRSTATOS 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

DESCRIPTION: 


Creates a status window which continuously reports 
information contained in the image. E.g. level, span, 
object parameters etc. 


EXAMPLE: 


IR.STATUS IRCHAN=1 






COMMAND: 


PARAMETERS: 


Thermovision^^OO Series 

ISOTHERM_HANDLING & 
ISOTHERM_HANDLING^QP 

IRCHAN 

IR channel number (1 or 2). 

ISOl (optional, default = current setting) 

Isotherm 1 switch. Values are ON or OFF, 

ISOIVAL (optional, default = current setting) 

Value of isotherm 1. Value is given in current presentation 
unit. 

ISOITYPE (optional, default = current setting) 

Type of isotherm: 

- ABOVE; highlight from ISOIVAL and above. 

- BELOW; highlight from ISOIVAL and below. 

- INT: highlight from ISOIVAL and below with 

width=IS01INT. 

ISOlINT (optional, default = current setting) 

Isotherm 1 width. (Only used if ISOITYPE = INT). 


IS02 (optional, default = current setting) 
Isotherm 2 switch. Values are ON or OFF. 






ERIKA Software Commands 


IS02VAL ’ (optional, default = current setting) 

Value of isotherm 2. Value is given in current presentation 
unit. 

IS02TYPE (optional, default = current setting) 

Type of isotherm: 

- ABOVE: highlight from IS02VAL and above. 

- BELOW: highlight from IS02VAL and below. 

- INT: highlight from IS02VAL and below with 

width=IS02INT. 

ISOlINT (optional, default = current setting) 

Isotherm 1 width. (Only used if ISOITYPE = INT). 


DESCRIPTION: 

Activate or deactivate isotherms 1 and 2. 

EXAMPLE: 

ISOTHERM_HANDLING IRCHAN=1, IS01=0N, IS01TYPE=INT, IS01INT=5. ISOl VAL=20 
ISOTHERM^HANDLING IRCHAN=1. IS02=0N. IS02TYPE=BELOW, IS01VAL=25 
ISOTHERM_HANDLING_QP IRCHAN=2 



Thermovision®^00 Series 


COMMAND: KEEP_BASE_TIME 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

DESCRIPTION: 

o 

Current image source is ordered to use the current image 
reference time for all images until change of image source. 

EXAMPLE: KEEP_BASE_TIME IRCHAN=1 

SEE ALSO: RESET_BASE_TIME SET_BASE_TIME TIMER 


o 

o 
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ERIKA Software Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


KEEP_COMMENT 

mCHAN 

IR channel number (1 or 2). 


Current image source is ordered to use the current image 
comment for all images until change of image source. 




KEEP.COMMENT IRCHAN=1 




RESET_COMMENT EDIT_COMMENT 


O 

O 
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Thermo vision^^OO Series 


COMMAND: KEEP^OFFSET 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

DESCRIPTION: 

^ ^ . ... 

Current image source is ordered to use the current offset 

correction for all images until change of image source. 

EXAMPLE: KEEP_OFFSET IRCHAN=1 

SEE ALSO: SET_OFFSET EDIT_OFFSET RESET_OFFSET 


o 
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ERIKA Software Commands 


COMMAND; LINE^FUNC 

PARAMETERS; IRCHAN 

IR channel number (1 or 2). 


LNUM 

Line number index. 


u 


MINV 

Activate (MINV=TRUE) or deactivate (MINV=FALSE) 
line minimum value. If the parameter is not used the 
current state prevails. 




MAXV 

AcUvate (MAXV=TRUE) or deactivate (MAXV=FALSE) 
line maximum value. If the parameter is not used the 
current state prevails. 


DIFF 

Activate (DIFF=TRIJE) or deactivate (DIFF=FALSE) the 
calculation of the difference between the maximum and 
minimum values. If the parameter is not used the current 
state prevails. 


AVER 

Activate (AVER=TRUE) or deactivate (AVER=FALSE) 
line average value. If the parameter is not used the current 
state prevails. 
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SDEV 

Activate (SDEV=TRUE) or deacUvate (SDEV=FALSE) 
line standard deviation. If the parameter is not used the 
current state prevails. 


MEDI 

Activate (MEDI=TRUE) or deactivate (MEDI=FALSE) 
line median value. If the parameter is not used the current 
state prevails. 


HIST 

Activate (HIST=TRUE) or deactivate (HIST=FALSE) line 
histogram. If the parameter is not used the current state 
prevails. 


PROF 

Activate (PROF=TRUE) or deactivate (PROF=FALSE) 
line profile. If the parameter is not used the current state 

prevails. 


LEN 

Activate (LEN=PIXEL or LEN=METRIC) or deactivate 
(LEN=NONE) line length function. The line length is 
calculated in meters/millimeters (METRIC) or in screen 
pixels (PIXEL). 


FREQ (Not yet implemented) 

Activate (FREQ=TRUE) or deactivate (FTIEQ=FALSE) 
line frequency table. If the parameter is not used the 
current state prevails. 








ERIKA Software Commands 


DESCRIPTION: 


Activates or deactivates line measurements tasks. 
Deactivation of a non-existing task will not cause an error 
report. All calculated results are shown in the result table. 


EXAMPLE: 

LINE_FUNC IRCHAN=1. LNUM=10, MINV=TRUE, MAXV=TRUE, DIFF=TRUE 
LINE_FUNC IRCHAN=1, LNUM=1, SDEV=FALSE, MEDI=TRUE, PROF=FALSE 
LINE_FUNC IRCHAN=1, LNUM=2, HIST=TRUE, LEN=METRIC 

SEE ALSO: ADD_LINE LINE_RESULTS 


o 


vJ 

o 
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COMMAND: 


Themiovision®^00 Series 


PARAMETERS: 


LINE_RESULTS_QP 

IRCHAN 

IR channel number (1 or 2). 

LNUM 
Line number. 

EXTR (optional, default=FALSE) 

Activate line extreme values if TRUE. 

STAT (optional, default=FALSE) 

Activate line statistics if TRUE. 

HIST (optional, default=FALSE) 

Activate line histogram if TRUE. 

PROF (optional, default=FALSE) 

Activate line profile if TRUE. 

LEN (optional, default=NONE) 

Select display mode of line length in the result table. 

NONE Deactivate line length calculation 

PIXEL Line length in screen pixels. 

METRIC Line length in meters (m) or 
millimeters (mm). 
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DESCRIPTION: 


A dialog panel allows the operator to choose which line 
results to present in the result table. The line results are 
activated or de- activated according to the panel choices. 


EXAMPLE: 

LINE_RESULTS_QP IRCHAN=1, LNUM=1, STAT=TRUE, HIST=TRUE 
LINE_RESULTS_QP IRCHAN=1, LNUM=2, LEN=NONE 


SEE ALSO: 


LINE FUNC ADD LINE 




Thennovision®^00 Series 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


MAKE_DIR & MAKE_DIR_QP 

NAME 

Name of target directory to create. 

LOC (optional, default = .) 

Name of directory where target directory is to be created 


Create a directory. 


MAKE_DIR NAME=LENNY, LOC=/HOAJSR 
MAKE_DIR_QP 


SEE ALSO: 


DELETE DIR 







ERIKA Software Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


MAKESOUND 

FREQUENCY 

Frequency of the sound (in Hz). 


DURATION 

Duration of the sound (in 128ths of a second). 




Makes the loudspeaker sound. 


O 


MAKE_SOUND FREQUENCY=440, DURATION=64 

CONTROL_SOUND 


o 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 


MOVE_FILE & MOVE^FILE_QP 

NAME 

Name of source file(s) to move. Wildcards (*** and *?’) 
are allowed. 

LOC (optional, default = .) 

Name of directory where the source files are located. 

NEW_NAME (optional) 

New name on destination file. Do not define this field if 
wildcards are specified in NAME. 

TO_LOC (optional, default = .) 

Name of directory where files are moved. 

DOS (optional, default = FALSE) 

Rename file according to DOS file naming rules. If TRUE 
then rename file if necessary. 


Move one or more files from a source directory to a 
destination directory. 


MOVE^FTLE NAME=:*.HIS, TO^LOC=../ERIKA 
MOVE_nLE_QP DOS=FALSE 







ERIKA Software Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


PRINT_FILE & PRINT_FILE_QP 

NAME 

Name of file to be printed. 

LOC (optional, default = .) 

Name of directory where file is located. 


Send file to current spooler device. 
The file has to be a text file. 


PRINT_nLE NAME=TEST.MAC, LOC 
PRINT_FILE_QP 


Thermovision®900 Scries 


COMMAND: RECALL_ANALYSIS & RECALL_ANALYSIS_QP 

PARAMETERS: ERCHAN 

IR channel number (1 or 2). 

NAME 

Name of macro file. If file extension (.MAC) is missing it 
will be added to file name. 

LOC (optional, default = .) 

Name of directory where macro file is located. 

DESCRIPTION: 


The default IR channel is set and the commands stored in 
the macro file are executed. 


EXAMPLE: 

RECALL_ANALYSIS IRCHAN=1, NAME=ANA1, LOC=STATES 
RECALL_ANALYSIS_QP IRCHAN=2 


SEE ALSO: 


STORE_ANALYSIS 









ERIKA Software Commands 


COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 


RECALLJCOMMENT & RECALL_COMMENT_QP 

IRCHAN 

IR channel number (1 or 2). 


NAME 

Name of file containing an image comment. 


LOC 

Name of directory where comment file is located. 


Current image source is ordered to use the new comment 
for all images until change of image source. 


RECALL_COMMENT IRCHAN=1, NAME=TEST 
RECALL_COMMENT_QP IRCHAN=1 


SEE ALSO: 


STORE_COMMENT 






Thermovision®^00 Series 


COMMAND: RECALL JMAGE & RECALL_IMAGE_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

NAME 

Name of image file. Wildcards (‘*’ and *?’) are allowed. 

LOC (optional, default = .) 

Name of directory where image file is located. 

DESCRIPTION: 

Switch to image source “OS9 source”. 

EXAMPLE: 

RECALLJMAGE IRCHAN=1, NAME=TEST, LOC=. 

RECALLJMAGE rRCHAN=l, NA.ME=*.IMG, LOC=IMAGES 


SEE ALSO: 


STOREJMAGE 
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COMMAND: RECALL_OBJPARS & RECALL_OBJPARS_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

NAME 

Name of file with object parameters. 

LOC (optional, default = .) 

Name of directory where object parameter file is located. 

OPNAME (optional, default = OPSC) 

Name of object parameter set (OPyyxx or OPSC; yy = SP, 
ARor LI, XX = 01..99) 

DESCRIPTION: 

Recall object parameters from file and send them to the 
current image source (OPSC) or to the analysis (OPOl - 
OP09). 


EXAMPLE: 

RECALL_OBJPARS IRCHAN=1, NAME=OB_SET, 
RECALL_OBJPARS_QP IRCHAN=2, OPNAME=OPSP07 


SEE ALSO: 


STORE OBJPARS 



Therniovision®^00 Series 


COMMAND: RECALL PLOT & RECALL_PLOT QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2).' 

NUM 

Plot window number (1-10). 

NAME 

Name of file with plot data. 

LOC (optional, default = .) 

Name of directory where plot file is located. 

DESCRIPTION: 


Recall plot data from external file and reinitiate plot 
curves. 


EXAMPLE: 

RECALL_PLOT IRCHAN=1, NUM=1, NAME=PLT1 .PLT, LOC=. 
RECALL_PLOT_QP IRCHAN=2 


SEE ALSO: 


STORE_PLOT 
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COMMAND: RECALL_SEQ & RECALL_SEQ_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

NAME 

Name of image sequence. 

LOC (optional, default = .) 

Name of directory where image sequence is located. 

DESCRIPTION: 

Switch to image source OS9 sequence. 


EXAMPLE: 

RECALL_SEQ IRCHAN=1, NAME=TEST, LOC=SEQUENCES 
RECALL_SEQ_QP IRCHAN=2 


SEE ALSO: 


STORE_SEQUENCE 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


REMOVE_ANALYSIS 

IRCHAN 

IR channel number (1 or 2). 


Remove analysis and all analysis related functions. 


REMOVE_ANALYSIS IRCHAN=2 

START. ANALYSIS 
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COMMAND: REMOVE_SHOW_TEXT 

PARAMETERS: None. 

DESCRIPTION: 

Remove latest show text window. 

EXAMPLE: REMOVE_SHOW_TEXT 




SEE ALSO: 


SHOW_TEXT 


o 
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O 


COMMAND: RENAME_FILE & RENAME FILE QP 

PARAMETERS: NAME 

Name of file lo be renamed. 

LOC (optional, default = .) 

Name of directory where file is located. 

NEW.NAME 
New name of file. 


DESCRIPTION: 


Renames a file. Wildcards are not allowed. 


EXAMPLE: 

RENAME_FILE NAME^OLD.TXT, NEW_NAME=NEW.TXT, LOC=, 
RENAME_FILE_QP 

SEE ALSO: MOVE_FILE 

o 

o 
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COMMAND: RESET_BASE_TIME 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

DESCRIPTION: 

Current image source is ordered to use the original image 
reference time for each image until change of image 
source. 

Relevant only for disk image source. 

EXAMPLE: RESET_BASE_TIME IRCHAN=1 

SEE ALSO: KEEP_BASE_TIME SET_BASE_TIME 
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COMMAND: RESETCOMMENT 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


o 


DESCRIPTION: 


Current image source is ordered to use the original image 
comment for each image until change of image source. 
Relevant only for disk image source. 


o 


EXAMPLE: 


RESET_COMMENT IRCHAN=1 


SEE ALSO: KEEP_COMMENT EDIT_COMMENT 


o 

o 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


RESET_LEVEL_SPAN 

IRCHAN 

IR channel number (1 or 2). 


Current image source is ordered to use the original level 
and span values for all images until change of image 
source. 


RESET_LEVEL_SPAN IRCHAN=2 


SET_LEVEL_SPAN SET_CURRENT_LEVEL_SPAN 
SET_ADJ_PERCENT ADJUST_LEVEL_SPAN 
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COMMAND: RESET^OFFSET 


PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


DESCRIPTION: Current image source is ordered to use the original offset 
correction for all images until change of image source. 


EXAMPLE: RESET_OFFSET IRCHAN=1 

O 

SEE ALSO: SET_OiTSET EDIT_OFFSET KEEP_OFFSET 


o 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


RESET_OBJPARS 

IRCHAN 

IR channel number (1 or 2). 


OPNAME (optional, default = OPSC) 

Object parameter set. (OPyyxx or OPSC; yy = SP, AR or 
LI, XX = 01..99) 

The current image source will distribute the default values 
for scale object parameters. 


o 


RESET_OBJPARS IRCHAN=1 


SET_CURRENT_OBJPARS SET_OBJPARS 


o 
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COMMAND: RESIZEJRWINDOW 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

SIZE 

Scaling factor for IR image. Recognized values are 2 for 
size 2:1 or I for size 1:1. 

DESCRIPTION: The IR window adjusts to specified display size. 

EXAMPLE: RESIZE_IRWINDOW IRCHAN=2, SIZE=1 

RESIZE_IRWINDOW IRCHAN=1, SIZE=2 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


RESTORE & RESTORE_QP 

LOC 

Subtree to restore. 


DEVICE 

Device to read backup from - /mtO for tape, /dO for floppy 




AFORMAT 

Archive format: TAR or MIW (Microware fsave formal). 


O 


Creates a control panel from which the restoring can be 
performed. 

RESTORE LOC=/HO. DEVICE=/MTO, AFORMAT=:MIW 

RESTORE_QP 

BACKUP BACKUP_QP 


o 

o 
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COMMAND: RUN^CMD & RUN CMD QP 

PARAMETERS: NAME 

Name of command. 

LOC (optional, default = execute path) 

Name of directory where the program file is located (if 
applicable). 

PARAMETERS (optional, default = >»ONIL 

BACKGROUND (optional, default = TRUE) 

Run command in background, an will be added to the 
end of parameter string if set. 

DESCRIPTION: An OS-9 command is executed in a shell, using the 
’system’ call. 

EXAMPLE: 

RUN_CMD NAME=BITMAP. PARAMETERS="MYOWN.BIT 30X30 »>/NIL&'‘, 


BACKGROUND=TRUE 




ERIKA Software Commands 


COMMAND: RUN_MACRO & RUN_MACRO_QP 

PARAMETERS: NAME 

Name of macro file. 

LOC (optional, default = .) 

Name of directory where the macro file is located. 

IGNERR (optional, default = FALSE) 

Stop on error. If TRUE then abort macro process on error. 

DESCRIPTION: 


A macro process is started and receives a priority channel 
to the command interpreter. Commands are read from the 
macro file and executed. The process is terminated at end 
of file. A macro is able to start a new macro and will wait 
for termination of the new macro before continuing. There 
is currently a limit of 10 macro levels. 


EXAMPLE: 

RUN_MACRO NAME=TEST, LOC=MACROS, IGNERR=TRUE 
RUN_MACRO_QP 
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COMMAND: SCALE_PLOT & SCALE_PLOT_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


o 


NUM 

Index for plot window. 


o 


FIX (optional, default = FALSE) 

Flag for fix scale. If TRUE then fix scale else auto scaling. 


MIN (option, default = 0) 

Scale lower limit (ignored if FIX=FALSE). 

MAX (option, default = 0) 

Scale upper limit (ignored if FIX=FALSE). 




TSCALE (optional, default = FALSE) 

Flag for horizontal time scale. If TRUE then time scale 
else image scale. 


o 


DESCRIPTION: 

Rescale the plot window. 


EXAMPLE: 

SCALE_PLOT IRCHAN=1, NUM=3, FIX=TRUE, MIN=20, MAX=40 
SCALE_PLOT_QP IRCHAN=2, NUM=2 
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SEE_ALSO: 

ADD_PLOT RECALL_PLOT STORE_PLOT DEL_PLOT 
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COMMAND: SCANNER_CONTENT 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


o 

o 


DESCRIPTION: 


Create a window which shows the calibration data of the 
scanner. 


EXAMPLE: SCANNER_CONTENT IRCHAN=2 


O' 

o 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 


SCANNER LOAD & SCANNER_LOAD^QP 

IRCHAN 

TR channel number (1 or 2). 

PROG (optional) 

Name of scanner program file. 

CALIBl (optional) 

Name of calibration file, part 1. 

CALIB2 (optional) 

Name of calibration file, part 2. 


Reprogram and/or recalibrate the scanner. 


EXAMPLE: 

SCANNER_LOAD IRCHAN=1, PROG=SC_PROG, CALIB1=CAL01 
SCANNER_LOAD_QP IRCHAN=2 





COMMAND: 

PARAMETERS: 

DESCRIPTION: 


Thermovision^OO Series 


SCREEN^COPY 


None. 


Make a screen copy of any window. The window must be 
in front of other windows. The copy is only a snapshot of 
the source window. 


EXAMPLE: 


SCREEN COPY 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 


SCREEN_DUMP & SCREEN_DUMP_QP 

IRCHAN 

IR channel number (0, 1 or 2). 0 means that the user 
interactively selects a window to dump. 1 or 2 means that 
the corresponding IR image (if active) is selected. 

LOC (optional, default = .) 

Name of directory where dump file is to be located. 

IFORMAT (optional, default = GIF) 

PC image file format (GIF, PCX or TIFF). 

NAME 

Screen dump file name. Extension is determined by 
IFORMAT. 


OVWR (optional, default = FALSE) 
Overwrite existing file if TRUE. 


WIN (optional, default = USER) 

Window type (1,2 or USER). USER means that the user 
interactively selects a window to dump. 1 or 2 means that 
the corresponding IR image (if active) is selected. 


Make a screen dump of selected screen window and pul 
the result into an external file. 
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1 


EXAMPLE: 

SCREEN.DUMP LOC=., NAME=TEST, IFORMAT=GIF, OVWR=TRUE, 
WIN=USER 

SCREEN_DUMP_QP IRCHAN=1 


o 


o 

o 
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COMMAND: 

PARAMETERS: 


I DESCRIPTION: 

( 

EXAMPLE: 

SEE ALSO: 


SET_ADJ_PERCENT & SET ADJ PERCENT QP 

IRCHAN 

IR channel number (1 or 2). 


PERCENT (optional, default = AUTO_LS_PERCENT) 

Percentage of temperature range. Ranges between the 
constants DLH_AUTO_MIN_PERCENT and 
DLH_AUTO_MAX_PERCENT. 



Set percentage of the image temperature range. This 
percentage is used at automatic adjust of level and span. 
The new percentage is stored in the environment variable 
DLH_AUTO_DFT_PERCENT. ADJUST_LEVEL_SPAN 
is executed with the new percentage value. 


SET_ADJ_PERCENT IRCHAN=1, PERCENT=90 
SET_ADJ_PERCENT_QP IRCHAN=2 


SET_LEVEL_SPAN SET_CIJRRENT^LEVEL_SPAN 
RESET_LEVEL_SPAN ADjrUST_LEVEL_SPAN 


o 


o 
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Thermovision®^00 Scries 


COMMAND: 

PARAMETERS: 


DESCRIPTION: 


SET_BACKGROUND 

TYPE (optional, default = DEF) 

Background type: 

DEF = Default background (only back & white). 
SOLID = One colour background. 

BMAP = Two coloured bitmap background. 


BG (optional, default = BLACK) 

Background colour (will not affect TYPE=DEF). 

Valid colours are: BLACK, WHITE and COLOUR 1 - 
COLOUR9. 

FG (optional, default = WHITE) 

Foreground colour of bitmap (will only affect 
TYPE=BMAP) 

Valid colours are: BLACK, WHITE and COLOURl - 
COLOUR9. 

BITMAP (optional) 

Bitmap file name (only for TYPE=BMAP) 

BITMAP_LOC (optional, default = .) 

The location of bitmap file (only for TYPE=BMAP) 


The command will change the colour of the screen 
background. 
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EXAMPLE: 

SET_BACKGROUND TYPE=DEF 
SET_BACKGROUND TYPE=SOLID, BG=COLOUR5 

SET_BACKGROUND TYPE=BMAP, FG=WHITE. BITMAP=stripes, BITMAP_LOC=bmaps 


u 
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COMMAND: SET_BASE_TIME 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


O 

o 


TIME (optional, default = CURRENT) 

Image base time. Valid values are: 

CURRENT = Use current image time. 
HH:MM:SS = User defined time. 

FRAC (optional, default = 0) 

Image base time, fractions of a second (0 - 999). 


DESCRIPTION: 


Current image source distributes the new image base time 
along with the images. The new value affects the system at 
next change of image. 


EXAMPLE: 


O 

SEE ALSO: 

o 


SET_BASE_TIMEIRCHAN=1,TIME=15:10:30, FRAC=237 
SET_B ASE_TIME IRCH AN=1, TIME=CURRENT 


RESET_BASE_TIME KEEP_BASE_TIME TIMER 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


SET_CURRENT_LEVEL_SPAN 

IRCHAN 

IR channel number (1 or 2). 


Retrieves the level and span values from the current image 
source and makes them “current”. These values are now 
distributed along with the images. The new values affects 
the system at next change of image. 


O 

o 


SET_CURRENT_LEVEL_SPAN IRCHAN=1 


SET_LEVEL_SPAN SET_ADJ_PERCENT 
RESET_LEVEL_SPAN ADJUST_LEVEL_SPAN 


O 

o 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


SET_CURRENT_OBJPARS 

mCHAN 

IR channel number (1 or 2). 

OPNAME (optional, default = OPSC) 

Object parameter set. (OPyyxx or OPSC; yy = SP, AR or 
LI, XX = 01..99) 


Retrieves the object parameters from the current image 
source and makes' them “current”. These values are now 
distributed along with the images. The new values affects 
the system at next change of image. 


SET_CURRENT_OBJPARS IRCHAN=2 


SEE ALSO: 


RESET_OBJPARS 
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COMMAND: SET_DATE_TIME & SET_DATE_TIME_QP 

PARAMETERS: DATE 

Date formatted as specified by DFORMAT. 


TIME 

Time formatted as HH;MM:SS. 




DFORMAT 

Determines format of DATE, Must contain YY for year, 
MM,mmm or month for month and DD for day, e.g. YY- 
MM-DD, YY mmm DD, DD/monih -YY 


U 


DESCRIPTION: 


Sets system time. Parameter values of DATE and TIME 
are ignored in the dialog panel command and replaced by 
current system time. 


EXAMPLE: 

SET_DATE_TIMEDATE=92-02-ll, DFORMAT=YY-MM-DD, TIME=15:20:00 
SET_DATE^TIME_QP 

O 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 


SET^DEFJRCHAN 

IRCHAN 

IR channel number (0, 1 or 2). 


Sets default IR-channel. When the default IR-channel is 
set (1 or 2), all other commands containing the parameter 
“IRCHAN” can be called without this parameter. This can 
be used to make macros independent of IR-channel. When 
the “IRCHAN” parameter is set to 0 (zero, only valid for 
this command), the default IR-channel is reset. 


EXAMPLE: 


SET_DEF_IRCHAN IRCHAN=1 
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COMMAND: SET_LEVEL_SPAN & SET_LEVEL_SPAN_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

LEVEL 
New level. 

SPAN 
New span. 

DESCRIPTION: 


Current image source distributes the new level and span 
along with the images. The new values affects the system 
at next change of image. 


EXAMPLE: 

SET_LEVEL_SPAN IRCHAN=1, LEVEL=2453, SPAN=658 
SET_LEVEL_SPAN_QP IRCHAN=2 


SEE ALSO: 


SET_CURRENT_LEVEL_SPANSET_ADJ_PERCENT 
RESET LEVEL SPAN ADJUST LEVEL SPAN 












Thermovision®^00 Scries 


COMMAND: SET_LOCATION & SET_LOCATION_QP 


PARAMETERS: LOC 

Name of directory which is to be “current directory”. 


DESCRIPTION: 

o 

Changes “current directory”. Current directory is 
displayed on the top line. 


O EXAMPLE: 


SET_LOCATION LOC=.. 
SET_LOCATION_QP LOC=/HO 
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COMMAND- 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


SET_OFFSET & SET_OFFSET_QP 

IRCHAN 

IR channel number (1 or 2). 


OFFSET 

New offset correction. 


o 


Current image source distributes the new offset correction 
along with the images. The new value affects the system at 
next change of image. 


O 


SET_OFFSET rRCHAN=l, OFFSET=200 
SET_OFFSET_QP IRCHAN=2 


RESET_OFFSET EDIT_OFFSET KEEP_OFFSET 


O 

o 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 


SET_PALETTE & SET_PALETTE_QP 

IRCHAN 

IR channel number (1 or 2). 


NAME 

Name of palette file to use. 


LOC (optional, default = .) 

Name of directory where palette file is located. 


Reads palette file into memory and activates the palette. 


EXAMPLE: 

SET_PALETrE IRCHAN=1, NAME=COLIRON, LOC=/HO/AS YS/LIB 
SET_PALETTE_QP IRCHAN=1 





ERIKA Software Commands 

COMMAND; SET^PORT & SET_PORT^QP 

PARAMETERS: BAUD (opuonal, default = 9600) 

Baud rate of serial port (300,1200,2400.4800,9600. 
19200). 

PARITY (optional, default = NONE) 

Parity of serial port (NONE, EVEN. ODD). 

BITS (optional, default = 8) 

Number of data bits (7 or 8). 

NAME (optional) 

Name of spooler device. 

DESCRIPTION: 

Changes the serial port parameters. Instead of spooler 
device an ordinary file name may be used to redirect all 
spooler output to a disk file in which case the three first 
parameters are not used. 

EXAMPLE: 

SET_PORT BAUD=9600, PARITY=EVEN. BITS=7, NAME=/tl 
SET^PORT_QP 


SEE ALSO: 


PRINT HLE 
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COMMAND: SET_SCALE_LIMITS & SET_SCALE_LrMITS_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

SLIMUP 

Scale upper limit in current unit of presentation. 

SLIMLO 

Scale lower limit in current unit of presentation. 

DESCRIPTION: 

Translates the scale limits to level and span values. The 
current image source will distribute the new level and span 
along with the images. The new values affects the system 
at next change of image. 

EXAMPLE: 

SET_SCALE_LIMITS IRCHAN=1, SLIMLO=0, SL1MUP=10 
SET_SCALE_LIMITS_QP ERCHAN=2 
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COMMAND; SET_OBJPARS 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


EPS 

Emissivity of object. 




TAO_EST 

Estimated transmittance. If 0 then do not use this value. 


O 


TATM 

Atmospheric temperature. 


TAMB 

Ambient temperature. 


DOBJ 

Object distance in meters. 

RELHUM 

Relative humidity in percent. 

O 


OPNAME (optional, default = OPSC) 

Object parameter set. (OPyyxx or OPSC; yy = SP, AR or 
LI,xx = 01..99) 
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DESCRIPTION: 

Changes object parameters. Specify only parameters 
which need to be modified. 


EXAMPLE: 

SET_OBJPARS IRCHAN=1, EPS=0.98, TATM=25, DOBJ=20 
O SET_OBJPARS IRCHAN=2, RELHUM=70, OPNAME=OPAR03 

SEE ALSO: RESET_OBJPARS 


o 

o 
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COMMAND; 

PARAMETERS: 


SET_SCANNER 


mCHAN 

IR channel number (1 or 2). 


MOTOR 

ON, OFF and if Stirling Scanner STBY 


o 


FRAME_RATE 
fflGH, LOW 

CASSETTE 

Filter cassette number ( 1*4 ) 

FILTER 

Filter number in cassette (1-6) 



TEMP__RANGE 
Temperature range (1-4 ) 

nLTERNAME 

An alternate way to select filter by name. 

The scanner will be searched for a filter with requested 
name and, if found, the proper cassette number and filter 
number will be set. 


o 

O 
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DESCRIPTION: 

Changes scanner setup. Specify only parameters which 
need to be modified. 


EXAMPLE: 

SET_SCANNER IRCHAN=1. MOTOR=ON. FRAME_RATE=H1GH. RLTERNAME=ATM 
SET_OB.rPARS IRCHAN=2, MOTOR=STBY. TEMP_RANGE=4. HLTER=2 . 


SEE ALSO: 


SCANNER_CONTROL_WINDOW 





ERIKA Software Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


SHOW_IMAGE 

mCHAN 

IR channel number (1 or 2). 


STEP 

Step length in sequence (positive or negative integer). 




Orders current image source to show next image from the 
current image sequence. Next image is determined by 
STEP (only relevant for disc image sources). 


O 


SHOWJMAGE IRCHAN=1, STEP=3 
SHOWJMAGE IRCHAN=2, STEP=-1 


o 

o 
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COMMAND: SHOW OTHERCHAN & SHOW OTHERCHAN QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

FILTERNAME (optional). 

Name of filter to use. 

FILTERPAR (optional) 

Filter parameter, if any necessary. 

DESCRIPTION: 


If no FILTERNAME is specified an image source is 
started which copies images from the other IR channel in 
real time. If 

FILTERNAME is specified then the images will pass 
through a software filter. The image frequency now 
depends on the complexity of the filter. 


EXAMPLE: 

SHOW_OTHERCHAN IRCHAN=1, nLTERNAME=MIRROR. FILTERPAR=X 
SHOW_OTHERCHAN__QP IRCHAN=2 


SEE ALSO: 


the help text NAMED__FILTER, for information about 
available filters and their parameters. 
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COMMAND: SHOW_TEXT 

PARAMETERS: NAME 

Name of text file to be displayed. 

LOC (optional, default = .) 

Name of directory where text file is located. 


BITMAP 

Name of bitmap file. 


DESCRIPTION: 


Displays a text file and, if specified, a bitmap. 


EXAMPLE: 

SHOW_TEXT NAME=LABEL.TXT, BITMAP=LABEL.BIT, LOC=/HOAJSR/ERIKA 

REMOVE_SHOW_TEXT COMPANY_LABEL 


SEE ALSO: 
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COMMAND: SHOW_TIME 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

PRES (optional, default = ABS) 

Type of time presentation. 

ABS = Absolute image time. 

REL = Relative time to base. 

OFF = No time presentation. 

DESCRIPTION: 

Display a time row in the result table(s). 
EXAMPLE: SHOW_TIME IRCHAN=1, PRES=ABS 

SEE ALSO: 

SET_BASE_TIME KEEP_BASE_TIME RESET_BASE_TIME TIMER 

u 

o 


o 


129 





ERIKA Software Commands 


COMMAND: START_ANALYSIS 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

o 

O 

DESCRIPTION: 

Starts the analysis and creates a result table. This is done 
automatically when creting analysis tasks, e.g. adding 
spots. 

EXAMPLE: START,ANALYSIS IRCHAN=1 

START_ANALYSIS IRCHAN=1, RESTAB=OFF 


RESTAB (optional, default = ON) 

Analysis result table on or off. 

ON = Result table presentation active. 
OFF = No result table presentation. 


SEE ALSO: 


REMOVE ANALYSIS 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


STARTFREERUN 

IRCHAN 

IR channel number (1 or 2). 


STEP 

Step length (positive or negative integer). 


The current image source starts a free-running image 
sequence with step length. Only relevant for disk image 
sources. 


START_FREERUN IRCHAN=1. STEP=1 


SEE ALSO: 


START_SEQ ST0P_D1STR 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


START_SCANNER 

IRCHAN 

IR channel number (1 or 2). 


Switch to image source scanner. 


START SCANNER IRCHAN=1 

o 


o 

O 
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COMMAND: START_SEQ 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


o 


STEP 

Step length (positive or negative integer). 

DESCRIPTION: 

The current image source starts a sequential image flow 
with step length. (Only relevant for disk image sources). 


EXAMPLE: START_SEQ IRCHAN=2, STEP=-] 

SEE ALSO: START_FREERUN STOP_DISTR 


o 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

NOTE: 

EXAMPLE: 


START_SKETCH 

IRCHAN 

IR channel number (1 or 2). 


SYMBOL (optional) 

Valid values are; SPOT, LINE, BOX, AREA, CIRCLE 
and ELLIPSE. 




o 


This command start the sketch mode in the IR-window for 
the specified symbol type. The analysis will be started, if 
not done before. 


This is an interactive command, and must not be used in 
macros. 


START^SKETCH IRCHAN=1. SYMBOL=CIRCLE 


O 

vj 


134 










Thermovision^^OO Series 


COMMAND: 

PARAMETERS: 


DESCRIPTION: 


START TOOLBOX & START TOOLBOX QP 

NAME 

Name of toolbox file, 

LOC (optional, default = .) 

Name of directory where the macro file is located. 

SHOWINF (optional, default = TRUE) 

If TRUE, then tool information will be shown. 


A toolbox process is started. It will read and interpret 
specified toolbox file. This file descibes the tools to be 
availible in the toolbox. Each tool will be associated with 
a button in the toolbox control panel. When pressing this 
button one of four types of commands can be executed: 


o An ordinary Erika command. 

0 An Erika macro. 

0 An OS-9 command, 

o An internal message command. 


EXAMPLE: 

START_TOOLBOX NAME=TEST, LOC=TOOLS, SHOWINF=FALSE 
START_TOOLBOX_QP 


I 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


STOP_DISTR 

IRCHAN 

IR channel number (1 or 2). 


The current image source stops the image sequence 
momentarily. 

(Only relevant for disk image sources). 


STOP.DISTR IRCHAN=1 


o 


SEE ALSO: 


START_SEQ START_FREERUN 
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COMMAND: 

PARAMETERS: 


STORE ANALYSIS & STORE ANALYSIS^QP 

IRCHAN 

IR channel number (1 or 2). 

NAME 

Name of macro file. If extension (.MAC) is missing it will 
be added to the filename. 

LOC (optional, default = .) 

Name of directory where macro file is located. 

TITLE (optional, default = empty siring) 

Title text for macro file. Maximum 30 characters. 

OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE overwrite any existing 
file. 


APPEND (optional, default = FALSE) 

Append to existing file. If TRUE then append macro 
commands to an existing analysis macro file. 
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FUNC 


Analysis function to store (AREA, LINE, SPOT, ALL). 
AREA Store all related area tasks (plot excluded) 

LINE Store all related line tasks (plot excluded) 

SPOT Store all related spot tasks (plot excluded) 

ALL Store all analysis tasks. 


o 


NUM 

Analysis function index, 1 - 99. Ignored if FUNC=ALL. 

o 


DESCRIPTION: 

The analysis functions are stored on file in macro 
command format. All channel related commands are 
stored without specifying the IRCHAN parameter. 


EXAMPLE: 

STORE^ANALYSIS IRCHAN=1. NAME=SAVE. TITLE=Test. FUNC=ALL 
STORE_ANALYSIS IRCHAN=1. NAME=L3, OVWR=TRUE, FUNC=LINE, NUM=3 


SEE ALSO: 


RECALL ANALYSIS 
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COMMAND: STORE_COMMENT & STORE COMMENT QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

NAME 

Name of image comment file. 

LOC (optional, default = .) 

Name of directory where comment file is located. 

OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing file. 

DESCRIPTION: 

The image comment of the current image source is stored 
on file. 

EXAMPLE: 

STORE_COMMENT IRCHAN=1, NAME=CM1, LOC=/DOS, OVWR=TRUE 
STORE_COMMENT_QP IRCHAN=2 


SEE ALSO: 


RECALL COMMENT 





ERIKA Software Commands 


COMMANEi: 

PARAMETERS: 


STORE_HISTO & STORE_HISTO_QP 

IRCHAN 

IR channel number (1 or 2). 


NAME 

Name of histogram file. Extension (.HIS) will be added if 
missing in filename. 


Vj 


LOC (optional, default = .) 

Name of directory where histogram file is located. 


TITLE (optional, default = empty string) 

Title text for histogram file. Maximum 30 characters. 


OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing file. 


FUNC 

Type of histogram to store (AREA or LINE). 


O 


NUM 

Analysis function index, 1 - 99. 


O 
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DESCRIPTION: 

Store histogram data and classes on external file. 


EXAMPLE: 

STORE_HISTO IRCHAN=1. NAME=HIST1. OVWR=TRUE. FUNC=LINE, NUM=23 
STORE_fflSTO_QP IRCH AN=2 
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COMMAND: STORE_IMAGE & STORE_IMAGE_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 

NAME 

Name of image file. Extension (.IMG) will be added if 
missing in filename. 

LOC (optional, default = .) 

Name of directory where image file is located. 

OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing file. 

DESCRIPTION: 

Store current image on file. 

EXAMPLE: 

STOREJMAGE IRCHAN=2, NAME=BT_01, LOC=., OVWR=TRUE 
STORE_IMAGE_QP IRCHAN=2 


SEE ALSO: 


RECALL_IMAGE 
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1 


COMMAND: STORE OBJPARS & STORE_OBJPARS_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2), 

NAME 

Name of object parameter file. Extension (.OPR) will be 
added if missing in filename. 

LOG (optional, default = .) 

Name of directory where file is located. 


O 


OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing file. 


OPNAME (optional, default = OPSC) 

Object parameter set. (OPyyxx or OPSC: yy = SP, AR or 
LI,xx = 01..99) 

TITLE (optional, default = empty string) 

Title text for file. Maximum 30 characters. 

DESCRIPTION: 

Store object parameter set on file. 
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EXAMPLE: 

STORE.OBJPARS IRCHAN=1, NAME=OB2. OVWR=TRUE, TITLE='Test set” 
STORE.OB JPARS_QP IRCHAN=2, OPNAME=OPU05 

SEE ALSO: RECALL_OBJPARS 


o 


o 
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II 


COMMAND: STORE_PLOT & STORE_PLOT_QP 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 




NUM 

Plot window number. 




O 


NAME 

Name of plot data file. Extension (.PLT) will be added if 
missing in filename. 

LOC (optional, default = .) 

Name of directory where file is located. 

OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing file. 

TITLE (optional, default = empty string) 

Title text for file. Maximum 30 characters. 




DESCRIPTION: 


Store plot data on file. Plot data is retrieved by the 
RECALL_PLOT command. 
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EXAMPLE: 

STORE_PLOT IRCHAN=1, NUM=2, NAME=PL1, OVWR=TRUE 
STORE_PLOT_QP IRCHAN=2 

SEE ALSO: RECALL.PLOT 




o 
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COMMAND: 

PARAMETERS: 


DESCRIPTION: 


STORE^PROFILE & STORE PROFILE QP 

IRCHAN 

IR channel number (1 or 2). 

NAME 

Name of profile file. Extension (.PRF) will be added if 
missing in filename. 

LOC (optional, default = .) 

Name of directory where profile file is located, 

TITLE (optional, default = empty string) 

Title text for profile file. Maximum 30 characters, 

OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing file. 

NUM 

Line function index, 1 - 99. 


Store profile coordinates and values on external file. 
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EXAMPLE: 

STORE_PROFILE IRCHAN=1, NAME=PROFl. OVWR=TRUE, NUM=23 
STORE_PROFILE_QP IRCHAN=2 


O 


O 

O 
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COMMAND: 

PARAMETERS: 


STORE_SEQUENCE & STORE SEQUENCE_QP 

IRCHAN 

IR channel number (1 or 2). 

NAME 

Name of image file. Extension (.IMG) will be added if 
missing in filename. 

LOC (optional, default = ,) 

Name of directory where image files are located. 

OVWR (optional, default = FALSE) 

Overwrite existing file. If TRUE then overwrite any 
existing file. 

APPEND (optional, default = FALSE) 

Append image files to an already existing sequence if 
TRUE. 

SEQ (optional, default = FALSE) 

Image sequence in one file. If TRUE then put all images 
in one file. File extension will be .SEQ. 

KEEP (optional, default = ALL) 

Keep images in sequence. If ALL then keep all images. If 
LAST/N then keep the latest N images. 









ERIKA Software Commands 


START (optional, default = NOW) 

Start condition for sequence storage, valid conditions are: 

NOW - Start immediately. 

TIME - Start at a certain time. (/HH:MM:SS) 

KTRIG - Start on keyboard trig. (/A or /B) 

ETRIG - Start on external trig. (/A,/B,/C or/D) 

Kj 


STORE (optional, default = ACC) 

Store condition, valid conditions are: 

ALL - Store all images. 

ACC - Store accepted images, 

CYCLE - Store at time interval. (/HH:MM:SS) 
KTRIG - Store on keyboard trig. (/A or /B) 

ETRIG - Store on external trig, (/A, /B, /C or /D) 



UNTIL (optional, default = FOREVER) 

Stop condition for storage, valid conditions are: 

FOREVER - Never stop. 

END - Stop at end of sequence. 

DUR - Stop after time duration. (/HH:MM:SS) 

NUM - Stop after storeing N images. (/N) 

KTRIG - Stop on keyboard trig. (/A or /B) 

ETRIG - Stop on external trig. (/A,/B,/C or/D) 


O 

o 
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DESCRIPTION: 

Store image sequence on file(s). Files are numbered in 
sequence. 

EXAMPLE: 

STORE_SEQUENCE IRCHAN=1, NAME=T1. START=TIME/12:00:00, 
UNTIL=DUR/2:00 

/ STORE.SEQUENCE IRCHAN=1, NAME=T2. STORE=ACC. UNnL=NUM/ 10 , 

KEEP=ALL 

STORE_SEQUENCE IRCHAN=3, NAME=T3, STORE=KTRIG/A, UNTIL=KTRIG/B, 
KEEP=LAST/5 

^ STORE_SEQUENCE_QPIRCHAN=2 
SEE ALSO: RECALL_SEQ 


O 

u 
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COMMAND: SWITCH_MODE 

PARAMETERS: SHOW (optional) 

Show dialog panels if SHOW=ON. If SHOW=OFF then 
no dialog panels will be displayed. 


PUT_DEF (optional) 

Save dialog panel values if ON. Parameter values entered 
into dialog panels are saved if PUT_DEF=ON. No save if 
PUT_DEF=OFF. 

MACRO (optional) 

Commands are saved in a command macro file if 
MACRO=ON. 

(Not yet implemented). 

EXEC (optional) 

Execute commands produced by dialog panels if 
EXEC=ON. 

DESCRIPTION: 


Modifies global flags in the command interpreter to affect 
the function in dialog panels. (Useful in macros). 


EXAMPLE: 


SWITCH_MODE SHOW=ON, PUT_DEF=OFF, 
MACRO=OFF, EXEC=ON 
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COMMAND: TERMINATE_IRCHAN 

PARAMETERS: IRCHAN 

IR channel number (1 or 2). 


O 


DESCRIPTION: 

Terminate specified IR channel. All functions connected 
to the IR channel are also terminated. 


O EXAMPLE: TERMINATE_IRCHAN IRCHAN=2 


SEE ALSO: CREATEJRWINDOW 


o 

u 
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COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 

SEE ALSO: 


UNFREEZE 

IRCHAN 

IR channel number (1 or 2). 


The current image source unfreezes the image flow. 




UNFREEZE IRCHAN=1 

(J 

UNFREEZE FREEZE 


o 

o 
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COMMAND: WAIT 


o 

O 


PARAMETERS: UNTIL 

Wait condition, valid conditions are: 

DUR - Stop after time duration, (/HH:MM:SS) 

TIME - Wait until a certain time. (/HH:MM:SS) 

KTRIG - Wait until keyboard trig. (/A or fB) 

ETRIG - Wait until external trig. (/A, /B, /C or /D) 

DESCRIPTION: 

Wait until condition true. 

EXAMPLE: 

WAIT UNTIL=DUR/3:45 (wait 3 minutes & 45 seconds) 

WAIT UNTIL=TIME/12 (wait until noon) 

WAIT UNTIL=ETRIG/C (wait until external trig C) 


o 

o 
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O 

o 
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ERIKA MACRO COMMANDS 


This is a brief description of all commands which are 
accepted by the Erika macro reader. The macro reader 
accepts all Erika commands listed under Erikacommands. 
Macro commands are prefixed with the character *$’. 

Below is list in alphabetical order of the available 
commands. Each command function the command name 
and parameter names are listed. Also a short functional 
description of the command. 


o 


o 
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COMMAND: $NOK 

PARAMETERS: None 


DESCRIPTION: 




The macro reader will execute the following command(s) 
only if the last command failed to return OK. 

The command sequence must be ended by $<. 


O EXAMPLE: FREEZE IRCHAN=1 

$NOK 

UNFREEZE IRCHAN=1 
FREEZE IRCHAN=1 
$< 


o 

o 


2-7 




ERIKA Macro Commands 


COMMAND: 

PARAMETERS: 

DESCRIPTION: 

EXAMPLE: 


$OK 


None 


The macro reader will execute the following 
command(s) only if the last command returned OK. 
The command sequence must ended by $<. 


FREEZE IRCHAN=1 
$OK 

UNFREEZE IRCHAN= 1 
FREEZE IRCHAN=1 
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COMMAND: SWAFT 

PARAMETERS: None 


DESCRIPTION: 


o 


The macro reader will suspend execution for 5 seconds. 


EXAMPLE: SWATT 

O 


o 

o 
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O 

o 


o 
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Description of histogram storage file. 

The contents of a HISTOGRAM, see RESULTS, can be 
written to a file. This file is an ASCII text file, the 
contents of which is described below. 

Here is a sample histogram file: 

#$Histogram storage 

#*.HIS Version 1 

#Histogram for AREA 01 unit CELSIUS 
#Image Scanner_l Fri Mar 13 09:49:35 1992 
##$ Long comment 
#* version 1.05 
AGEMA Infrared Systems AB 


#Range (low 

- high) % 

Acc % 

# 

< 

35.1 

0.0 

0.0 

35.1 - 

35.3 

0.0 

0.0 

35.3- 

35.4 

0.0 

0.0 

35.4 - 

35.5 

0.6 

0.6 

35.5- 

35.6 

3.9 

4.5 

35.6- 

35.8 

17.3 

21.8 

35.8- 

35.9 

17.6 

39.4 

35.9 - 

36.0 

25.0 

64.4 

36.0- 

36.1 

25.0 

89.4 

36.1 - 

36.2 

8.3 

97.7 

36;2 - 

36.4 

2.4 

100.1 

> 

36.4 

0.0 

100.1 
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Description of histogram storage file 


All lines starting with the character are comment lines. 
Thefirst row is file title which is displayed if a detailed 
directory listing is made. The second row is the file 
version number indicating changes in file format. These 
two rows are found in all ERIKA system files. 

The rest of the file concerns the histogram. 

The third row states the analysis function used and 
temperature/signal unit. 

The fourth row states the image source, date and time. 

The following rows shows the image comment. 

The histogram file ends with a frequency table which 
corresponds to the classes in the histogram. At the moment 
the number of classes is fixed to 10. The table also lists 
two more classes, i.e. the range from the lowest class and 
below and the range from top class and up. 

The table has three components: range, percentage and 
accumulated percentage. 

The range unit is specified in the third comment row. The 
range may also be tagged with a readout warning. The 
percentage column shows how many samples in percent 
that falls into the specified range. The accumulated 
column shows the percentage of samples up to the upper 
range limit. 

Due to rounding errors the accumulated percentage may 
differ from 100 %. 


G 


The presentation of temperatures or object signal is 
sometimes accompanied by a readout warning: 

- means “No value exists”. This happens for instance 

when the scanner is disconnected or a value far outside the 
current calibration is found. 

* 1234 means “Uncalibrated”. The value is just outside 
the current calibration and may still be usable. More than 
10 % of the usable values in the area or line are tagged 
with warning status. 

? 1234 means “Unreliable”. The value is not ok at the 
moment. The reason may be that the scanner is stabilizing 
after a change of aperture. 


o 

o 
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O 

O 
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Description of plot storage file 


When the PLOT function is active, the acquired plots are 
written to RAM. The last 1000 plots are stored and can be 
written to a file. This file is an ASCII text file, which can 
be taken up on the screen or written to a printer. 

Here is a sample plot file: 

#$Plot storage 
#*.PLT Version 1 

SPOl TEMP Temp #Task label row 

Active: 1 Type: 1 Index: 1 Subtype: 0 #Task status row 
Comers: 1 #Task coordinates 

(24,11) 

SP02 TEMP Temp 

Active: 1 Type: 1 Index: 2 Subtype: 0 

Comers: 1 

(67,7) 

SP03 TEMP Temp 

Active: 1 Type: 1 Index: 3 Subtype: 0 

Comers: 1 

(107,10) 

001 92-03-13 09:49:29.343 0 36.055382 1 36,055382 1 35.868092 1 
002 92-03-13 09:49:30.276 0 35.961784 1 35.899334 1 35.961784 1 
003 92-03-13 09:49:31,209 0 35.836838 1 36.117725 1 36.211163 1 
004 92-03-13 09:49:31,942 0 36.211163 1 35.680408 1 35.617764 1 
005 92-03-13 09:49:33,009 0 35,899334 1 35.899334 1 36.117725 1^ 
006 92-03-13 09:49:33.742 0 35,680408 1 35,805573 1 35.805573 1 
007 92-03-13 09:49:34.541 0 35.743015 1 35.930565 1 35.649090 1 
008 92-03-13 09:49:35.607 0 35.805573 1 35.680408 I 35.743015 1 
009 92-03-13 09:49:35.941 0 36.086559 1 35.899334 1 35.930565 1 


All lines starting with the character *#’ are comment lines. 
The first row is file title which is displayed if a detailed 
directory listing is made. The second row is the file 
version number indicating changes in file format. These 
two rows are found in all ERIKA system files. 
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Description of plot storage file 


A plot laski description is made of all active plot tasks. 
Each task description consists of a task label row, a task 
status row and up to 64 rows specifying to task 
coordinates. 

The task label row is a redundant row showing the same 
data as the task status row. The first field indicates which 
analysis function is used as plot source. The second field 
shows the internal code for which function value to plot. 
The spotmeter task has only one value to plot - its 
temperature or signal value. The area and line tasks has six 
different values to plot: MINV, MAXV, DIFF, AVER, 
MEDI, SDEV. The third field is what the plot displays in 
the plot label. 

The plot status row has four components: Active, Type, 
Index and Subtype. 

Active indicates if the plot task is activated (1) or 
deactivated (0). 

Type indicates if task type is SPOT(l), AREA(2) or 
LINE(3). 

Index is task index and ranges from 1 to 99. 

Subtype indicates which task value to plot. The spotmeter 
does not have any subtypes and will always plot its 
temperature/signal value. Area and line tasks have six 
different subtyj^s: Diff (1), Min (2), Max (3), Average (4), 
standard deviation (5) and median (6). 

The task coordinates consists of one row showing the 
number of task singular points and then a list of those 
points. 

After the task descriptions comes the plot value table. A 
plot table can hold up to 1000 values. A row in the plot 
value table, has the following format: 

<no><date><time><dst><value Ixvalid Ixvalue 
2xvalid 2xvalue 3xvalid 3> 
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Each field is separated with a space. 


<no> 

Plot value number. Ranges from 1 - 1000. 

<date> : 

Plot value date. Format is yy-mm-dd. 

<time> : 

Plot value time. Format is hh:mm:ss.fff and 
fff means fractions of a second and ranges 
from 0 - 999. 

<dst> : 

Daylight savings active (1) or inactive (0). 

<value x> 

: Plot value in floating point format. No 
unit is specified. 

<valid x> 

Indicates if plot value is valid (1) or 
invalid (0). 
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How to make USER DEFINED MENU’S 

in ERIKA 

The addition of USER DEHNED MENU’S in ERIKA 
take place through manipulation of the file .agwmrc 
which can be found under /HOAJSR/ERIKA. 

Be careful with this file. You might easily destroy it if you 
try to manipulate it, so the first thing to do is to make a 
copy of it. 

1. Make a copy of .agwmrc to .agwmrc.old 

2. Read the file .agwmrc into the text editor. 

3. In the file under *‘Pointer Button definitions” add 
the following line: 

Button3= :root :f.menu “userdef’ 

This means that the menu will come up when you 
click with the right button of the mouse on the 
back ground (‘ root ’). 

4. Under “System menu tree” write after the } sign 

# USER DEFINED MENU 
menu “userdef* 

{ “USER DEHNED MENU” f.tiUe 

“Add spot in IR-1 ” f.funkey “add_spot irchan= 1, 

pos=25:25”} 

If you want a more complete series of functions to be 
carried out when you select this menu, then the last line 
can look like this: 

“Add ...” ffunkey “RUN^MACRO LOC=/HO/ 
USR/ERIKA, NAME=MACRONAME.MAC” 

The macro has to be written before, of course. 

5. When all changes have been written to the editor, 
then click on OK to store the changed file to the 
hard disk. 

6. Click on the top line menu. Select the “Reread . 
agwmrc” 














How to make USER DEHNED MENU’S 


7. Test by clicking on the background if the right 
button calls up the USER DEFINED MENU you 
have just written. Check the function. If you are 
happy with it, then you must now store it to the 
place from where the file is read when you boot the 
system. 

8. In /HO/ASYS you can find the same .agwmrc as the 
one under /HOAJSR/ERIKA, which is used at boot- 
up. 

Be extremely careful not to change this .agwmrc 
under /HO/ASYS as it is your only way to make the 
system work if you have written a syntax fault in 
your modified .agwmrc. 

If the system does not understand your modified 
.agwmrc because of some severe syntax fault, then 
after some time it read the .agwmrc from /HO/ 
ASYS, so for security reasons, do not change that 
file!!! 
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EXTERNAL INPUT/OUTPUT 



The THV 900 systems have four trig inputs and four 
outputs. Two of the inputs are opto-isolated for use with 
an external power supply and two that only need external 
closing contacts. The four outputs are for future use. 

DESCRIPTION: 

One D-type connector at the System Controller rear panel 
holds 4 inputs and 4 outputs. 

The connector is marked EXT IN/OUT. 


u 



o 

o 


Isolated triggering inputs: 

These inputs require an external power source. 

As these inputs are opto-isolated there is no risk of 
ground-loops and minimum risk of having excess voltage 
fed to the system controller by mistake. 

Trig description: 

No current applied to input pins: No trig 

Current increased to trig level 

(corresponding to about 4 V 

between input pins, any polarity): First trig 

No trig 

No trig 

Second trig 


Current kept above trig level: 

Current decreased to below trig level: 
Current increased to trig level: 
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External Inpiit/Output 

Trig A (isolated): 

Input between pin no 11 and pin no 23. Any polarity. 
Input voltage: 4 V (min) 

12 V (max) 

Input load: 10 mA at 5 V 

Trig B (isolated): 

Input between pin no. 10 and pin no. 22. Any polarity. 
Input voltage: 4 V (min) 

12 V (max) 

Input load: 10 mA at 5 V 

Non-isolated triggering inputs: 

These inputs are used when an external closing contact is 
used with the system controller as driver. 

Note that internal voltage and ground from the system 
controller is brought outside the unit. 

Trig C (non-isolated): 

Closing contact between pin no. 13 and pin no. 25. 

Trig D (non-isolated): 

Closing contact between pin no. 12 and pin no. 24. 








